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Fvovn fUe E^AlFovs 

An Event That 
Changed Our Lives 


30 years ago this April, two guys who's names have Ixrome household 
words and one no one except his motlier and father lias ever heard of got 
togetlier and sUirted a venture that changed the world lived in l>y everyone who 
re:ids and works on tills magazine. Tlie three guys? Steve Wbzniak, Steve Jol>s, 
and Ron Wayne, 'llie Steves, witli very different personalities, priorities and 
objectives liave, l)y anyone's standards, achieved astounding sutrcxiss. As for Ron 
Wayne, who six days after Apple t(K>k an order for its first 50 "computers’", sold 
his 10% interest in Apple for $800, it seems Mr. Wayne has no regrets, has moved 
on witli hLs life and Ls happy that he iruide die riglit die decision Ixised on die 
information availalile to him at the lime. Given his original stake in Apple, if held 
until Apple's peak share price in 2(XK), would have lieen worth over $500 million, 
we have to say Ron Wayne is a man made of mucfi stningcj' stuff dian we! 

Three recent licKiks, in very different ways and with very different areas 
of focus, have done a great jol) of capturing the spirit of the company; iLs 
teclinology and the culture that has evtilved around it over these 30 years. 
Tile Ixxiks are; 

Revolution in The Valley: The Insanely Great Story of How the Mac Was Made 

By Andy Hertzfeld with a Forward by Steve Wozniak 

OTeilly Media 2004 

httpV/wwworeilly.com/catalog/revolution/ 

Apple Confidential 2.0: The Definitive History of The World's Most Colorful Company 

By Own W. Lonzmayer 

No Starch Press 2004 

http://www.nostafch,com/frameset.php?startat=apple2 

The Cult of Mac 

By Leander Kahney 

No Starch Press 2004 

http://vvww.riostarchxom/frameset.php?start3t=apple2 

Revolution in The Valley 

Andy Hertzfeld, who began his journey documenting liis story of co- 
parenting the Mac on liis site wwwinlklare.org, has done a magnificent job 
of sltaring his most insiders' view of tile pniccs.s that went into creating the 
Mac. In a series of stories that feel almost like extemporaneous narrative, Andy 
relates the tale of the Mac's creation with such intimacy^ spontaneity and spirit, 
liie reader feels like he is right tliere along side Andy and his mates, sharing 
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Fvovh fUe E<AiFovs... 

CoHHv\lAe-A 


with them their daily quest for engineering fx^rfectiun. Andy’s masterful 
storytelling makes the reader feel more like a participant Uian an observer, 
Highlights for us are: 

• Reading Andy's handwritten technical notes and coniinerils on A-traps 

• Watcliing him pii77Je through die process of fitting all that stuff [nio such a tiny 
memory footprint 

• Seeing Bill Atklnsonls i>ictures of the evolution of the graphics aipnlillities of botli 
the Lisa and the Mac, fascinating Sluflll 

• Andy's impressions of the Mac team, lK>th famous and unlicralded, the 
interrelationships of the players, learning his impressions of who were the real 
players vs. the imitators, who were the people who were tmly on a quest to 
change die world as opposed to those who were simply looking for yet another 
way CO gnitify their personal ego needs, lie really didn't hold anything back. When 
you reiid his thotights in this regard you know you’re getting his true feelings. 

• All those old icons and screenshots of early Mac DAs, Control Panels anti the 
Finder. Wow did that liring back memories! 

This is a book for geeks! There is a lot of low level stuff on the creation 
of lx)th the hardware and .software, the challenges the engineers on Ixjth 
sides were confronted with, tlie irade-ofls tliat had to Ixr made as a result of 
both memory limitations and die cost points the team thought they needed 
to hit to ensure Llie Mac tady would be The t'omputer for the rest of ns”! 
The folks at O'Reilly liave done a wonderful job of laying out the Ixx^k in 
an interesting yet pleasing fashion. If you love the Mac and want to hear the 
story of its creaiicm from one of its principal creators, a guy who was there 
almost from the project's first day right up until the machine shipped, we 
liiglily recommend this book! 

Apple Confidential 2.0 

To Ixr honest, when our friend Patrida Wirkin, the Communications 
Manager at No Stiirc:h Press, www.nostardi.com, sent us a copy of Owen 
Lon/mayer’s updated version of “Apple Confidential”, our first rhouglit was, 
"Just what the wtjrld needs: Ant)iher retelling of one of the most ohen told 
stories in the history of American business.'' You have to undersUuid, while 
we have great respect for Ixjth Owen's writing ability and his knowledge of 
Apple and iLs industry, we have read virtually eveiy word ever published on 
the subject. We're happy to report our first rc^adton could not have l^en 
more off the mark. Owen lias done a really impressive job of l^ringing a fresh 
perspective to the subject. He lias done a great deal of in-deptli research, 
chose to highlight aspects of the story that are tmly worth retelling, and did 
it all with an entertaining narrative .style that drives the reader to keep turning 
the [lages. Through access to many of the principals, lie has even managed 
to dig-up some stories and anecdotes we haven't heard l>efore. 

Some particularly memorable (and in some aises new) stuff: 

• Wtjz's story of how Apple got its name, Steve Jobs came up with it, from 
where Woz knows not; Woz initially hated it, but couldn't come up with 
anything they liked l>elten So it was Apple by elimination! 
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• "rhe explanation for Kon Wayne's early bailout from Apple 

• The chapter entitled ‘'Woz's Wtmderlngs”, which citronicles the 
adventures Woz had during his early posL-Apple days- Whctlier it was 
Owen's intention or not, this chapter also captures the essence of die key 
differences ixilween what drives tlie two Steves, and why, it's our guess, 
they would never lx; the very closest of friends. 

• A gcKKl telling of John Sculley’s Apple tenure 

• A verbatim pulilishing of u 1985 memo Bill Gates sent to John Sculley 
and Jean-Louis Gassee that, if heeded, would have lead to the Mac OS 
becoming the standard desktop platform instead of Windows. 

• A really good telling and analysis of the Mac done fiasco. Anyone out 
there still have a Power Computer? J 

• A well written and concise wrap-up chapter on Steve JoIVs return to 
Apple and the company's iransformation from an IT to a consumer 
electronics company 

Once again, we are happy to he able to strongly recommend “Apple 
Confidential 2.0” to anyone who is intere.sted in the Mac, Apple, the 
CHimputer industry or who just enjoys a compelling story told very well. 

The Cult of Mac 

It's rare in our experience when we feel comfortable using the words 
"unique” or “original” to descrilx; something that's lx;en published about the 
Mac, but these worIs apply very well to Leander Kahney’s amusing and 
pleasurable book. Beautifully done from a design and puKluction 
standpoint, "'The Cult of Mac” d(>es a great job of chronicling w!iy people 
merely USE Windows machines, but LOVE Macs. 

From the books cx)ver of a guy witlt Aj>ple's logo expertly shaved into 
the l>ack of his head, all the way through to pictore of a mom, very much 
in lal:)oi; witli her iPtxl in hand, earbtids plugged firmly into her ears, 
Leander, who in case you didn't know is Wirecl News' Mat: guy, does a 
simply wonderful joli of eapturing people's fascination with, deep passion 
for, and in many cases obsession with all things Ap[>lc. 

This is a truly a visually striking book. Leander and the folks at No 
Starch have produced a lH>ok that would be a treat even wiihtnit the 
wonderful narrative that acetHupanies the eye-ealching pictures and 
stunning design. Tliis book was made by people who posses the same 
sense of style and design that differentiate Apple's products from the rest 
of the ttiarketplace. And it’s written and published for the pteople who 
understand this difference and Ijccause they do, buy and love the 
products Apple makes. 

For the record, Patricia Wilkin was kind enough to make lx>th Owen 
and Leander available to us (or interview and commcni. We wish our 
editorial schedule (and VERY full plates) had allowed for the lime to do this. 
We're sure they would have had a bunch of very interesting stuff to share 
with our readers! 
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GETTING STARTED • by Dave Mark 


MySQL: PHP’s 

PERFEa Partner 


I figure, if you're re^ading this article, 
you are probably prett>^ new to the database 
universe and. therefore. MySQL is a gtKxl 
choice for you. But just in case youVe 
wandered into the room witlt some existing 
expertise, but are new to ojK-n Mxjrce 
soltitions like MySQL, here's a great URL lha! 
will tell you wliat MySQL d(X‘s differently 
than ANSI StaniLird Query Language: 

http:/ydev,mysqLcom/doc/mysql/en/Oifferences 

_ffom_ANSl.html 

MySQL is rock-solid, and incredibly fast, 
lliere aiL' more than five million active 
MySQL installatkjns in the world and MySQI. 
has Ix'en downloaded more than ten niiilkm 
times, Mxhsi are of the LAMP variety 
(Linux/Apache/MySQiypHP/Perl). Lots of 
Mac and Windows mups as well, lliere aa* 
a numi>cT of lientiimarks dial show MySQL 
as the fastest such systems availafilc. faster 
than the most expensive commercial 
DBMS's, faster even tlxin PostgreSQL 

MySQL use.s the GNU General Public 
License (GPL). Want to nin it on your 
personal computer? No charge! Compare 
that to the $!,000 per seat licenses of some 
commercial DBMS apps, or the $50,000+ 
cast for some commercial server packages. 
And chances are good that if your ISP offers 
PHP, theyll offer MySQL as well. MySQL is 
not fiard to find. 

In diis month’s column, we’re going to 
install MySQL, then make sure it’s set up 
and ready to use. If you don't already have 


a reasonulily recent version of PHI’ installed on your computer, 
now wnukl be an excellent time to do so. 

Installing MySC^L 

With each new reltrase, the folks at MySQL AB (die 
corporate entity that owns tlie riglits to MySQL) liave made it 
easier and easier to install MySQL, In the early days of Mat' OS 
X. insiullation was a Ixrar. You had to locate the source code, 
build and debug, searching the net to find info on the many 
compile switches, till you finally made your way tlmmgh a 
sut'cessful build. You then needed to deal wnih owneiship issues 
to make sure someone couldn't creep over the net and illicidy 
access your tables* Working with early MySQL releases retfuired 
a real pioneering *spirit. Nowadays. insLallatit>n is fairly straight¬ 
forward. almost iriviaL 

Early versions of Mac OS X rcqtdred that you go through 
the process of creating a new user named mysql. 't'hat user was 
given ownership of the installed files that were not owned by 
Root. Most folks added the mystjl account using the Accounts 
pane in Sysfem Preferences. That worked fine, thougli it 
createLl some files and diarciories that would only l^e used by 
a human user and added tluit user to the set of users presented 
at login. 

Nowadays (since the release of Mac OS X 10.2), Apple 
takes care of this bit of business for you. Though they don't do 
the installation of MySQL, recent versions of Mac OS X create 
the mysctl user as part of the System install. To see this for 
yourself, go into your Applications directory, Utilities 
subdirectory, and launch NeUnfo Munugeriln the Finder, note 
that shift-command-U is a .shortcut to the UlHiries directory). 

When Netlnfo Manager's main window appears, use its 
browser to locate the users directory. You should see a user 
named mysq! in the second column (see Figure 1). Notice the 
values for home and shelf Since we won’t l>e logging in as 
mysq!, tliere's no reason for a shell and home directory. 
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A few month’s back, I wrote about PHR We walked tlii'ough the 
installation process, then went tlirough the basics. PHP is a 
wonderful tool, all on its lonesome. But boy does it shine 
when you add a database backend to the mix. There are 
several database systems that work well with PHP. If you’re relatively new 
to this business, or if your database requirements are not particularly 
sophisticated, MySQL is the perfect choice. 
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aiek the lock to make changes. 


Figure 1. Netinfo Manager^ showing the mysql user. 
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Figure 2 shows the links of interest when 1 navigated there. 
Notice tlie Mirrors link. When you click to this page, ihc site 
will use your IP address to briiid a list of mirror sites it thinks 
are geographically close to you. You1l definitely want to check 
this page out if you run into prohlems dt>wnloading from tlie 
main site. 


Mirrora - fftf raster duwnLuad'Sp use our download mfrrois- Choose your tNjsest m Error From 
htre. 

HvSQC itHtabase server & tlondartt dlont«: 

• Mygoc 4 V " Ob fief ally Available (GAJ nilcasc (retommeodfrd) 

■ MvSOL 4 Q -- Genwatly Avoiladle (GA) release 

■ MySOi S.Q — Doveropment rtdeaso (uso this for provlewlno and testing new fcatuH^os) 

• outer ffcteAses ofder releasts toniy recomnwntted for special needsji 
- source code snapshots of the development tre« 


Figure 2. The important links on the downloads page. 

Next on the list is the latest GA (Generally Available) 
release, followed by the previous GA release. After that is the 
latest preview releaxSe (essentially a beta). 1 would definitely 
stick with the attest recent GA release. Click on that link. 

F’or me, the most recent GA release was MySQL 4A. 
Clicking on that link brrjught me to Lite MySQL 4.1 Downloads 
page. Take a minute to read the text at die top of the page: 


Downloading MySQL 

Tliough the net is full of tons of excellent MySQL 
resources, by far the most importani is found ai MySQl/s 
official home at http://www.mysqLconn. Most of the stuff we’ 11 
be interested in lies behind the i.Jeveio/3er Zone tab at 
http;//dev,nnysqlxom. To start your download decision-making 
process, navigate to the main download page: 

http://dev.mysqLcom/downloacts/ 


The MySQL dataliase server is available under the 
MySQL AB "dual licensing” model. Under this model, 
users may choose to use MySQL products under the 
free software/open source GNU General Public License 
(commonly known as the “GPL”) or under a 
commercial license, 

Click on the GNU Genera] Public License link, dien on the 
commercial license link. In effect, you can use the MySQL 
server at no cost to you, if your app is lOO^i GPL. This is the 
beauty of Open Source and the GPL mexiei. If you are nut 
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fiimiliiir wilh GPL or arc new to Open Source, it is well worth 
your time to read through the MySQL license pages. J think 
they are very well written and very understandable. Worth 
taking the time to do this. 

If you are just in learning mode, the GPL license is fine. The 
commercial licease is for people who do not want to release their 
source code or who find the GPL licensing rules tm restrictive. 
The cool thing is, even tlie commercial license is relatively 
inexpensive when compared to other commercial products. 

Scroll down the MySQL 4. ? Downkrdds page until you come 
to an area lal>eled Mdc OS X downlmds. As you can see in 
Pigiire 3, this part of the page is divided into 4 different sets. 
Two are installer-based, two are tar-ball based. There's one of 
each type for Jaguar and one for Panther. WeVe going for the 
Panther version with the installer package. 



Now that weVe decided tliat, we need to decide between 
stdnddfd, max, or debug versions of the server software, YouVl 
use tlic debug versi<m if you were trying to debug the MySQL 
source itself, or if you were trying to track down a particularly 
knorry problem in your code and needed to see the MySQL 
symbols. Note that, as with any software package, there's a 
signilicant perfonnance hit associated with die debug version. 

'Lhe max version includes a number of esoteric features that 
you mtxsl likely won't need (the NDB storage engine, Berkeley 
DB storage engine, lIDFs, B1G_TARLE support, etc.) The 
fe^itures in max tend to \:>e beta in nature and will migrate to the 
standnrd release as they stabilise. 

Bottom line, stnndurd is the one you want. So, if you 
have Panther installed, you'd go to the Mac OS X downloads 
section, then click on the 4^^^ overall kick a mirror link. It'll 


be the first link in the subsection labeled Installer package 
(Mac OS X vlOJ). 

Once the mirror page appears, you might want to use the 
login link to create a new MySQL account and login. With a 
login, you'll be able to post questions to die foRtm, subscril^e to 
the MySQL newsletter, etc. Worth it. 

Once you’re logged in, click on the closest mirror, then go 
gel a nice piece of halvah. Tap, tap, Lap. Done yeL^ Ah, Lhere 
you go. If you downloaded the installer package, you’ll get a 
xlmg file which should automatically mount as a disk image. 
Open the image. You’ll see two packages and a readme file. The 
first package is the MySQL seiver package. The second installer, 
called MySQLStartupRenhpkgj installs a Startup Item which will 
automarically ,stan up the MySQl, server at bcKit time. If you are 
going to spend any amount of time widi MySQL, you 11 want tills 
Startup Item installed. 

,Siart with the main package. Then iasiall the .Startup [tern. 
If you run into any problems, dig into die readme file. Tiicre’s 
a iof of lieipfui info in there. 

Starting the Server 
for the First Time 

Your next step is to start the MySQL server, so we can start to 
play! The .simplest way to do tliis is to just restart your a>mputer 
and let the Staitup Item do its thing. But ifs worth seeing how this 
is done by hand, just to get a sense of how this works. 

Fire up Terminal, tiien type this command: 

man ps 

When you hit return at the end of the command, one page 
wordi of die manual page for die command will disfday in 
die Terminal window, and a colon {:) prompt will appear at the 
botioin of lhe screen. You are looking for the list of opiions lo 
the ps coinniand, specifically descriptions of the "-a” and ‘"-x" 
options. To move down a page, hit the space bar. To quit, either 
hit enough spaces to scroll to the end or type the letter q. 

Tlie listing for '‘-a” says, “Display information alx>ui odier 
Lisers' processes as well as your own." llie listing for “-x” says, 
"Display information alxmi prtKesses without controlling 
terrninais." Let's combine these two, like so: 

-ax 

You’ll see a long scTolling list of processes. At this point, 
none of them should have the w^ord mysql in them. Unless you 
have a really wide monitor, the commands will likely get 
clipped, making diem hard to read. Try this command instead: 

pa ax > Lextfile 

This does the same thing, but redirects the pr(x:es.s listing 
into a text file named textfde. Unless you’ve s|x?cificaDy cJianged 
directories since you started up terminal, the file should be in 
your home directory. Go into the Finder, look in your home 
folder, and dmg texifilc onto TextEdit. That’s lietter! 

Now let’s start die server. At the command prompt, type: 


10 MAf!CH* 2005 


WWW.MACTKH.COM 







sudo /Library/StartupIteni^r/MySQLCOM/MySQLCOH start 

The sudo command is asking Unix to do this command as 
super user, or rrx>t. You should be prompted for your root 
password. Once you successfully enter your password, you 
should see this message: 

Starting MySQL database server 

Cool Now do your ps ^ax again and you should see two 
process entries that resemble these two: 

3®3 71 S 0:00.03 sh ./biTi/ssy5qld_safe - 

datadir=/usr/lacal/mysql/data --pid' 

flle^/usr/local/niysql/data/Dave-Miarks-Coraputer .local .pid 
403 77 S 0:02.06 /usr/local/inysql/bin/mysqld 

defaults extra flle=/usr/lacal/jniysqi/data/iLy.cnf 
basedir=/tisr/iocal/iiiysql -datadir=/usr/lot:al/mysql/data — 
U£er"=^ysql -pid - filW usr / local/niysql /d 

Ibe firsr enny is the shell wrapper for the server daemon. 
Basically, this shell is acting purely as a wrapper and a safe way 
to communicate witli tlie server 

The second entry is the server daemon itself. Though the 
daemon does ail the work, you .shouldn't have a need to 
communicate with it directly. Notice that the daemon is running 
with Liser=mysql and not as root. is the right way to do this, 
Kunning as rcxii would create a dangerc.^us security hole. 

Want to shut down die MySQL server? Don't worry, it's 
perfectly hne to do this. Type this command: 

sudo /Library/Startupl teats/MySQLCOM/MySQLCOH stop 

Check your ps -ax again. The two processes should be 
gone. Go ahead and start the .server again, .so we can play a bit. 
When you restart your machine, the Startup Item issues the ,same 
command you’re using to start the server: 

sudo /Library/StartuprteaiEi/MySQLCOH/MySQLCOM start 

Setting Up the Aliases 

To help save some typing, let’s set up a couple of aliases. If 
you are using bash shell, type these two coiiumnds: 

alias niysql=/usr/iocal/mysql/bin/jnysqi 

alias mysqladmin=/usr/local/mysql/bin/mysqladmin 

If you are using almost any other shell, type these two 
comtiiands: 

alias mysql /li^r/local/myaql/bin/mysql. 

alias fflyaqladmin /uar/1 ocal/jnysql/bin/tnyaqladmin 

If you are not sure which shell you are using, check the tide 
of the Terminal window. It should say. Or ju^it type one of the 
seLs above. If you get an error, try die odier set. 

Once you’ve successfully executed one set or die odier, add 
the two lines to your shell’s startup file so These two abases will 
be setup automatically each time you open a new Terminal 
window. For now, just type the commands and leave the 
Terminal window open so the aliases stick around. 

Now, if you type mysr//, you'll exeemte the ct>mmand 


/mr/kx::il/niys(it/htn/rnys(^l and when you type [jiysqiudmln, 
you’ll execute the command /usr/local^mysql/hin/mysqhdnm. 
Aliases are very useftiL 

Setting Up the MySQL Accounts 

Our la.st step before we actually start playing with MySQL 
itself Ls to secure the default MySQL accoonrs and set up a non- 
root account for our dabbling pleasure. 

MySQL ships with two nxit accounts anri two anonymous 
accounts that do not have passwords. Obviously, a dangenjus 
situation, though one that makes perfect sense from the 
vendor's perspective. 

Tlierc arc a numi^cr tif ways to do tills. Wc’ll use the mysql 
alias we just set up. In Terminal, type diLs command: 

mysql -u coot 

Tills coniniand starts up die mysql monitor using die rtxit 
user. Note that this is not the same as your Unix roof account. 
MySQI. maintains its own list of users, as well as iLs own data 
security model diat allows these users to own die MySQL data. 
Normally, when you start up the mysqj client, you’d tyjx a user 
name and a pa.ssword. Since there is no nxit password yet, all 
we need do is sjxcify die usct naiiie. niyst// will reply as Ibllows: 

Welcome to the MySQI. monitor. Commands end with : or \g. 

Your MySQL connection id is I to server version: 4.1.8- 
stcindard 

Type ‘help:" or Ah' for help. Type Ac" to clear the 
buffer. 

mysql) 

Notice that you are now ainning the MySQL monitor. The 
prompt at the bottom of the Terminal window is the standard 
MySQL prompt. You can exit die monitor by typing die 
command exit, followed by a reairn. Don’t do this quite yet! 

MySQL ships with a user table that holds all its account 
info. Let’s ask the monitor to list die host and user colunms in 
that table. At the mysqi> prompt, type tliis command: 

eelect host.user from mysql.user: 

Notice the semicolon (;) at the end of the command. Very" 
important!!! ITie semi tells the monitor that weVe reached the 
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host 

user 

Dave-Marks -Computer.local 


Dave-Harks Computer.local 

root 

iocalhost 


localhost 

root 


end of the cotniiiand. Here’s the results on my comjiuier: 

4 rows In set (0.64 see] 
mysql) 

Notice that i’ve got 4 accounts, 'I’wo root accounts, two 
anonymous accounts. One of each type is for connecting from 
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the local host. The other is for connecting from any other host. 

Let's add some passwords to these accounLs^ keep tlie had 
guys out! Still in the monitor, lyije tliis command, replacing 
xxxxx with the password you want for your local anonymous 
account, yyyyy with the host name from the host column above 
(the entry in that column that is not localhost) and zzzzz with 
tlie password you want for your second anonymous account; 

SET PASSWORD FOR ^‘ localhost ^ “ PASSW0RD(‘xi£3txx^); 

SKT PASSWORD FOR ^'^'yyyyy^ = PASSWORDCszzaz^; 

'lliis IS the reply 1 got to each of these commands: 

Query OK. 0 rows affected (O.OO sec) 


Here's my results: 


password 


M8796D3Efi21AOFB8Ffi9503C1006CF26DS17330 
n6756n3Efi21A0FB8F695O3CJD06CP26O33733O 

2 rows in set (0,00 sec) 


root 

root 


Notice dial my anonymous accounts are gone. If you 
somehow forget your root password after you do this, here's a 
link to a page that tells you how to reset the password: 

http;//dev.mysql,com/doc/mysql/en/Resetting_permissions.html 


]f you'd like some evidence that you just changed the 
pa,ssword, try this command: 

select password.user ftoin niysq],uaar: 


Here's the resuli f got, after 1 added iriy passwords: 

+ ^----- + - + 


password 

user 

M37g6D3E621AOFB8F69503C1006CF26D337330 
• 18796D3F:62 IAOFE8F695Q3C10D6CF26D337330 

root 

root 

4 rows 111 set {0.00 sec) 



Notice that the password column is siored in an encrypted 
form, as you might expect. Notice also that tile root passwords 
have not Iieen set yet. We ll do those next. Finally, note that 1 
changed both my passwoitls to llie same value. Good slnitegy? 
Perhaps not, but 1 wanted to show die consistency of the 
encryption. In real life, 1 delete the anonymous accounts 
completely, since I don’t like them hanging around. Warn to try 
this? Here'.s how you delete your anonymou.s accouaLs. Do nor 
type these coiiimatid.s, unless you really don’t want your 
anonymou.s accounts!! 

DELETE FROM mysiil. user WHERE User = 

FLUSH PRIVILEGES; 


Till Next Month... 


We did a lot this month. Hut the real fun comes in 
my next MySQL column when we really get into this 
.stuff. We'll create tables, add data and, eventually, use 
PUP to pull that data out of the database and display 
it in a web page. Cool! 

Not sure if we’ll do all this next month, but HI try. 
In the meantime, be sure to check out the new books 
at http://spiderworks.com. Rumor has it dial there’s a 
.series tif Tiger books in the works. Automator, 
Dashboard, and Spotlight, Excelleni! See you next 
month... © 
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The first command deletes the unnamed users from die 
user table. The second command is necessary since the table is 
only read when the server is first started. This prevents us 
having to restart the server 

Our last task is to set passwords for the root accounts. 
As you did before, substitute your new root password for 
xxxxx, your host name for yyyyy^ and your .secxmd root 
(lassword for zzzzz. 

SET PASSWORD FOR ' roof ' localhoflt* ^ PASSWORD ('xxxxx*) 1 
S ET PAS S WORD FOR ‘to o L'^'y y yyy' = PA S SWOR D f' zz zx x')i 

Feel free lo use diis command again, to check your results: 
select password,user from mysql.user; 
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3,248 hours typing code 





184 hours finding that one bug 
142 hours of meetings 


14 cancelled weekend trips 

i i 

j,. 11 all-nighters 

1 call protects It all 


The new HASP family of products 
Is the next generation in protection 
ensuring the highest levei of security 
for your software. It provides an 
easy to use set of tools to protect 
once and deliver through a variety 
of iicensing options. 



For Windows, Mac OS, Linux 

■ Data encryption with industry standard hardwaro-based 
AES UUW 

^ Strong wrapper with code obfuscation prevents debugging 
and reverse engineering 

^ API code generator for easy implemeniation and customiiation 

< Single and muld user license management 
^ Secure license updates for keys In the field 
Innovative licensing models defined separately from protection 





Gef the kit: Developer'^ Software, Guide and Demo Key at www.Qiaddinxom/ha^p Aladdin 
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Enterprise Database Technology 



Confronting the Myths and 
Challenges of the Enterprise World 

By David Swain 


There ufos^real anltcipaiton in the a4pUal dly of ibe Land 
of Smiles/Among the young, who bad never seen other times, 
there W£is talk of a neir Goiden Age coming where their new 
data engines would once again help iheir land become a world 
power in commerce and an eimi mightier force in the arts. 
They were rightfully proud of the achieifcments of their land's 
techno-artisLs and of the m>rld's renewed mtetesi in their 
advanced electronic creations. 

But those who were older and who did remember the 
eufiier Golden Age viewed the coming boom in commerce with 
both joy and dreadYes, it was possible that a much larger share 
of the tmrid's u^aith of information would nouf rely on their 
people ami technology* for safekeeping and secure access. And it 
was possible that grexU economic rewatds wouM enrich their 
fair land as a ^^$idt of this newfound global respect But it was 
also possible that a few key mistakes tnade ai Just the mrmg 
moment and in just the wrong place could bring disaster 
where there should ham been success. This could build an eimt 
greater barrier between the JMttd of Smiles and the outside 
ufortd, forever closing them off from the great spiritual and 
physical treasures that could have been theirs. These eiders 
remembered how the Land of Smites really fell out of favor with 
the business uforldyears ago... 


Myth vs Reality 

There are a number of myths that tlrcniate through the 
enterprise world and shape the behavior and decisions of those 
who work in ihal environinenL Myths are veiy powerful when 
enough i:>eople l^elieve them. They are cautionary tales intended 
to keep the inexperienced from harm. Hut if they are still 
believed by tliose wlio have otherwise reached matmity, they 
can impede progress and stifle growth. 

As with any myth, enierprise information technology myths 
may very well have some Ijasis in fact or in histoiy. But they are 
more often misinterpretations, sometimes deliberate, of facas or 
events that are fueled hy fear of the unknown and fanned by 
people with stimelhing to selL Even if the l>asis of a myth was 
true at some historical time, it may no longer bt true. Continuing 
to foster such a myth ctaild hcH-ome a harrier to progress. 

Such is our first myth.,. 

Myth #1 - There Arc No Enterprise 
Database Tools for Macintosh 

Not ail in the land of Smiles had abandoned the rituals of 
data management with the native technology in those }*ears. 
But those who persisted in this practice often did so in secret, 
fearing ridicuie or banishment Many sought refuge in other 
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lands in order lo pfy tbeir craft - ami many of those became 
suallowed up in the foreign culture that bad f>ecome their 
home. Some et>en began to belieife the vicious rumors they 
beardfrom Ibeir neighbors about the land of Smiles, or at least 
they nodded in assent in order to bietid in. Bui most longed in 
private Jor the day they could return to their beloved land and 
freely pursue their chosen trade... 

Ofllic widely held beliefs in the enterprise database market, 
one of the most prevalent categories of belief regards the use of 
Apple producLs and Mac-based software for “serious” work. 
Basically put, the core lx;lief is that "there are no enterprise-level 
database application development tools” biiili for this platlbrm. 
With the growing number of powerful Apple server jModucts 
facing i^orchased, with the return of more "visible” riatahase 
products like Oracle to the Macintosh platform, and with a little 
education, this misperceplion c'an change. 

But to facilitate tliis cliaiige, many of us will have to learn 
some new skills as well. And we must also learn to use the 
right tools to do the best job. If we choose tlic simpler tools 
witli wliich we are familiar in die small business market to 
attempt to build mission-critical applications for the enterprise 
market, we may find ourselves liecoming the source of new 
myths that the Macintosh platform is not suitable for 
professional database work. It is not a matter of whether we 
can use a certain tool, but whether we should use that tool 
when there are belter tools available. 

Years ago tliere were many small business systems built 
using software that ran on the Macintosli operating system - 
some belter than others. It was a simpler time when the word 
“gigal>yte" had never been uttered in polite conversation and the 
tools of the day on any platform were much less sophlslicated 
(or c^apable) than they are now. Some database companies that 
remained with die Macintosh platform since that time have made 
great progress. And the increasing acceptance of Mac OS X 
Server and Apple server and mass storage products should bring 
more of die major daialxise server companies back as well. Bur 
how well equipped for enterprise database work is Mac OS X 
even now? 

The Stale of the Platform 

It is not well known in enterprise database circles, but Mac 
OS X has nemr lieen without powerful enterprise-level uxils for 
information management. While die coming of Oracle has 
hroughi much“dcscrvcd attention to Mac OS X and Mac OS X 
vServer as database client and server platforms, ecjoally t:apablc 
products have Ixjen wiih us since die Ix^ginning. The very day 
Mac OS X offidally sliijiped (Saturday, March 24, 2001), an 
excellent SQL database product named FronrBase officially 
shipfxid its new Mac OS X version, joining successful versions 
already running on Linux and Unix systems. Another fine SQL 
database named OpenBase also shipped for OS X at that time, 
having also spent the long OS X beta period lioning its abilities, 
(We are pa^ssing over the MySQL that came installed with OS X 


lietiause it was stiM missing some important pieces for enterprise 
work,) More such products have come to the party since then. 

The day before OS X shipped, a database client appticaiion 
development kkiI named Omnis Studio shipped its first version 
designed to run on Mac OS X, filling out a prfxluci line iltai 
already ran on Classic Mac, Windows, Linux and Sun Solaris. It 
wa.s already t^apahle t>f creating client applications on Mac OS 
X for datal>asc servej^ running on otlier platforms, hut from the 
beginning it was also able to connecT with FrontBase as part of 
a joint effort lietween the two companies. 

The programmers at FrontBase had created a link (called a 
Data Access Module, or DAM) that allowed Omnis Studio to 
serve as a "front end” for their pix)ducL using the native syntax 
of Fr£)ntBasc\ Tlic tTC*ators of Omnis Studio had developed this 
DAM technology over many years and that program shipped 
with a number of DAMs For [)tlier tlmalrase engines. But they 
alsr:) make the APIs for this technology available to SQL 
database companies with legitimate needs so that those 
companies can build an Omnis Studki DAM for llieir own 
prfxluci^. Doing so in easence gave FrontBase an excellent and 
full-featured GUI development tool for both desktop and web 
browser-based applications without having to build one 
themselves. The grxxJ ftilks at OjjenBase followed suit by 
publishing their own native DAM for Omnis Studio a few 
months later 

The beauty f>f the DAM technology is that it allows Omnis 
Studio Lo speak the native SQL dialect of each database engine 
while maintaining a single t:ode base in an Omnis Studio 
application, in essence iK'corning a universal translator among 
all the SQL engines for which an Omnis Studio DAM exi.sts. Rut 
is this really necessary? Isn't SQL already a standard and 
universal language? 

Myth #2 - SQL is a Standard Language 

The imrid bad become a confusing place in that dark age. 
Only people could make such simple things so complkaled 

liveryone in the winde imHd spoht the same language - 
hut not exactly. They all used the same words, but many of the 
most important tmrds often had vastly tliffereni meanings 
from one group to the next. Words that speak of love in one 
society elicit greul offence in others. 

No one knew bow this came aboul hut everyone agreed 
on one thing: Their own group's use of language followed the 
one true and correct tradition. All others were vulgar dialects, 
unfit far civil discourse and indicating a km^fer intellectual 
capacity on the part of the speal^. 

No fence is as high m the one buiit by the mvtd.., 

SQL a universal language? Almast tme... But in practiol 
terms, SQL is a model for a database language basc^ on a standard. 
Its implemeniaiion in aaual database products varies widely. We 
ciinnot go out and purchase “SQL". If all SQL databa.scs were 
exactly alike, there woiM be no reason to have more dian one of 
them. IxKjk at the marketing spin of a few products- 
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FrontBase prides itself in strictly adhering to the SQ1792 
standard, for example, to the point where they even suggest that 
programmers purchase C* J. Date's A Cuide to the SQL Stfindanl 
as a reference manual to their prodma. But even FrontBase adds 
extensions to that standard for practical reasons. Of)cnBase 
published a 14-page white paper on how their produa complies 
ixrtter with a variety of chila integrity and security standards 
^which every database should incei, but few do” it> distinguish 
themselves. And Oracle is, weD, Oradef to die point where 
everyone else mentions in their own campaigns how they are 
equal to or better dian Oracle at scjmething imponanq bin still 
much more affordable. 

Why emphasize this here? 'the point is that there are 
significant differences among SQL database products. On many 
scales, neither is better or worse thin die odier. Each choice lias 
its trade-offs. Switching from one to another is where tlieir 
differences jvaliy make a difference to us. Tw^o actors c'an work 
from the same script in entirely different ways and both create 
equally brilliant performances. But problems would arise if we 
suddenly had to swap in, say, Hoffman for Pacino after all the 
shooting on a movie had lx:en done (just liecause new 
management was better friends with HolTniatVs agent). It 
doesn't matter that the script was the same for each 
jDcrfonnancc; the inter/nvtation of the script is the reality we 
must deal with. 

Fommately, in an enterprise database application we don't 
necessarily have to rewrite the whole thing just because a 
decision is made to change dataliase engines. Tltis is bec'ausi.^ of 
the way such applications are srnictiired. 

Division of Labor 

If you have only worked with file sliaring or self<ontuined 
datal>ase prtxlucts, then you may not be fully aware of ihe 
division of lalx>r in a client/server system. Brieny, dicre are twi) 
parts to a client/serv'er database appliaition: the Database and 
the Ap[ilication. Wliile diis may not seem to be a blinding flash 
of brilliance or a startling revelation, it is a distinction that is 
often blurred in practice - to the detriment of the finished 
system. Here Is how these two part.s could tx^ defineti: 

• The Database part protects and serves the information for 
the system. Tliis is also called the hack end of the 
application, tl is made up of the SQL .server engine and data 
repository that reside on a database ser%^er machine (or 
cluster). The SQL .server sits on this machine and responds 
lo requests for accessing the various databases it manages. 
Data access requests include select, insert, update and delete 
commands, but there are also requests for changing the 
struaure of a daiahase and for managing user access to a 
database or specific parts of it. 

• The Application part includes programs nmning on client 
machines elsewhere on die network that provide the Glfl 
interface for operations such as presenting data, acce[>ting 


data entry and generating reports. This is also called xhe front 
end of the application. The Application sends requests to rhe 
Database and receives responses from it, but it also may 
perform other tasks and may interact with other services 
(such as email) and devices (such as printers). 

Of course, opinions vary as to whea^ the lx)undaries of 
these two domains should really be placed, but the division is 
well acogiiized. Some databa.se publishers actively encourage 
including functional bits of application code direcUy in the 
database, partly as a mean.s of disc'ouraging shifting to another 
databa,se in the future. Developers at some “stable" installations 
(where diey are fairly certain management will not change 
databases on them) find that this practice has some perfonnance 
IxinefiLs. But many application developers who must serve users 
of various SQL engines prefer to put as mucli functionality into 
the Appliaition side as possible for easier portability. 

Client and server programs will generally reside on different 
miicliines (except possibly for web-lxised application servers) - 
and those machines can even lx* running different Ofxrating 
systems. As long as a communication f^ridge am l?e established, it 
dtxsn'L matter where the Database and Appliairion are relative to 
one another. But for our purptxses in llxs series of articles, we w^ill 
foais on 100% Mac OS X solutions, with Ixitli client and server 
machines running on some kind of mtxlern Macintosh machine. 

The issue of iiianagemeiU's effect on database decision¬ 
making fuis been broached. kK>k at this a bit more closely. 

Myth #3 - Our Company Has 
Standardized On XYZ 

Data artists were more ofien sertmits than masters^ Theirs 
was an obscure, secrelitK' (rude with many mysticai unwds of 
potifir to be nuistered. But they had protected tfjeir crafi so well 
that true skiit was rare, so mwty of tfx^ Biggest businesses 
succumbed io tbe lempiaiiou of outsourcing to other iands 
wiMie mteliectual tabor urn cheapecThis. in turn, bad often ied 
to less than satisfactoty resuits. but managers are not 
pmgrammers mid their expertise is in hudgeLs ratbet* than in 
bits and bytes.,. 

And managers were also servants of eiieti more poiverfut 
masters. When these masters ufere displeased, it was the 
ntanageis who bore their umth- This was both a biessing and a 
curse for tbe data artist... 

Ftir ilie pa.st many years now, the enterprise IT sphere has 
lx;en in flux, whih management turnovens happening fretjucntly. 
Changing management often signals changing database 
platform. Typic-ally, when a new VP of IT enters office, an 
impression must l>e made that immediate progress arrived with 
the change in management. A common taclic for making a 
stmng first impression is to change the database platform 
and/or operating system on which that company is 
“standardized”. Tlie rationale for such changes is most often that 
the new platform is “more powerfur or “more standard” or 
even “less expensive in the long term" or arguments along those 
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lines, but the real reas<)n is as likely to be that the new W of 
n (and die upper management staff that arrived on those 
coattails) is simply more familiar with that product or has some 
relationship with that company. 

Someiiines it doesn't even require a ckinge in management 
to shake things up. Service coniraas come up for renewal 
|:)eriodically and computers bought in a bundle come lo “end of 
life” and “necxl” to l>e replaced in a single, massive move. 
Negoiiations over price of ujKlating can l:>e enough to c^mse a 
change of '‘standards”. 

None of ihLs is necessarily bad, as iliis tactic may bring more 
coqxjiations to Mac OS X soonen And being in bed with a major 
database supplier - at least ft>r the span of a few years - may 
actually have Ixmefits for a corpr>ration. But however it tx:curs, 
such a ciiange rausc's an iiiunediate major headache for the staff 
in the trenches, who must aaually work with the new hardware 
and/or software and solve the problems brought a[x>ui by 
management’s change of heart. Wliat pn>l)lcms? Tlie problem 
dial Ixnh the data and the application from the current system 
must be converted to the new environment. 

Why is this a profilem? Well^ SQL comes in as many flavors 
as there arc vendors with SQL databases as we have already 
seen. Also, different o|x?rating systems require different software 
- and some database prcxlucis are only availaf>le for certain 
platforms, tf management is fully committed to a proposed 
change in standards (that is, if they imtst diat there be no 
exceptions), then a numlx^r of changes conirl cascade from a 
single decision. 

For example, a company that had l?een running MS SQL 
Seiver and that now intends to move to an all Macintosh 
network must also decide on a new datal)ase vendor, since 
Micrtjsoft dtxrs not make a Mac OS X version of diat prexlua. 
Sure, this company could keep a lonely outcast Windows 
machine on die network and continue to use it as a database 
server, but d^ai goes against their new' “standard". If the 
Application is also written using some tool that does not exist for 
Mac OS X (like Visual Basic), then that has to be entirely rebuilt 
as well. Many Ix^Iieve dial jol) security is a wonderful thing, but 
the unreasonably short timetables that sometimes come with 
such turnovers could even shake the foundations of that belief 
in the short term. 

A parallel t>roblem confronts those who would like to 
develop vertical market applications for selling intc> some 
segment of the enterprise market. Many conx>rations are 
adamant atxjui only using dieir (current) “standard” database 
platform - and this “standard" varies from one company to 
another (as well as from year to year tn some creses). This makes 
the developer's jol> more difficult if their code needs to be built 
for each specific back end. Supporting multiple code bases ts a 
tltankless task and is a real pain when it comes to providing bug 
fixes and upgrades! 

I liear someone in the Ixack mumbling something aixmt 
ODBC, 'late, many database prcxhicts can be accessed using 
ODBC (acronym for Open DataBase Connectivity), l)yl diis d(XS 
not yield tlie same kind of performance and access to security 


features as does using the n;itive dialect of each specific dalaixase 
prcxiiict. ODBC is merely a technology, like SQL, tliat was 
originally intended to give applicatioas (such as spreadsheet and 
chan generation programs) that live outside the datalrase 
applinirion access ro that dita for spccriali/x-d tasks. Such access 
would generally only lie one way - wading data but not 
ujxlating it. Just like Omnis Studio DAMs, ODBC drivers miisi 
still Ix" written for each database phiifcjrm we need to access. 

Certainly ODBC" is tlie native dialect of MS SQL Server (after 
all, ODBC lx!gan witli Microsofl) and a few other produers, but 
it does not by itself give acce.ss to important (and sometimes 
]>roprierary) internal features of specific SQL [>r(xlucts. ODBC 
compliance is still an impoUatit feature for applicatkjns that need 
to queiy^ SQL databases, but it Ls not part of the SQL standard. 

JDBC (the ja%^a cousin of ODBC from Sun) is a Java API for 
connecting to SQL databases and “other tabular data sources”. It 
lias similar intent and limitations to those of ODBC, but offers 
its API to the Java language rather than to varianUs of C, 

But what if we warn a compkle database application 
development platform - one that can take advantage of built-in 
and proprietary features for a variety of S(3L pnxlucts. as well 
as the more common anti mundane tasks, as well as provide a 
rich GUI interface all wiiliin a single ctxle base? What if w'e need 
to be prepared for occasional, or even frequent, transfers of data 
between different SQL prcxiucts? Where might we Look for a 
programming platform that can serve these needs? 

Omnis Studio to the Rescue 

TOcn Jibe was younger, in the prevtous age, she was i^ry 
serious about protecting and retrieifing data and about 
interacting with the largest and most pouferful engines - et>en 
the foreign ones. But she did not smile Ufeil This did not bring 
her favor in the Land of Smiies, so when others appeared who 
had far better smiles, her countrymen turned (heir backs on 
her to follow them. Bui too late they leartwd that smiles are not 
all that is important in this tmrk and so many limjects failed 
that the land of Smiles bad to bear the shame for many years. 

She had sj/enl the last age In the shadows, gaining 
knowledge and power, always seeking to fulfill her purpose in 
Jddlitating data access. She journeyed to the other nations - 
the land of the Sun, the land of ihe f^nguin and the iMnd of 
a Tfjousand Flags - and bad dwelt among their data mastef^ 
and had learned the special ways of each. She speaks the 
languages of all of their data engines as though sIm were a 
naliw... and she has learned ihe proper smile for each land - 
etmi of Ihe land where smiies are rare. 

Now the land of hef^ birth is again ready for greatness In 
the information world and she is ready to lead the 
iransformationf She is Omnis, the communicator, the 
facilitator, the guardian of the truth of the data - and the 
friendly face on the complexities of enterprise ... 

Tlie database conversion problem outlined above could 
prove to be a daunting challenge if it were n{)i hx tcxjls like 
those found in Omnis Studio. Its SQL Browser facility makes 
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quick work of tl\i.s otherwise tedious and laborious process, TJie 
compLiier still has to do the work, of course, but the programmer 
dcK^sn’t liavc to spend a lot of time and effort on it as well. After 
allj isn’t that why we use computers in tiie hrsi place? 

The "secret” is that Omnis Saidio uses a specially designed 
facility called a Data Ac:cess Module or DAM to communicate 
with each database in its own syntax. This Facility knows how to 
properly handle data of various types for each platfonii and 
translate each value between its native format and a form that 
Omnis Studio can use. There arc alscj many SQL feaiure.s built 
into objects within Omnis Studio that generate SQL code 
appropriate for the current database connection - even when the 
application is simultaneously connected to multiple and 
dissimilar SQL servers. Omnis Studio provides a common 
language, a “database Esperanto” if you will, that allows us to 
program tlie common SQL of)eraiions for an application once 
and then have them proy>erIy translated to tlie syntax for the SQT. 
product to which an application element Is cunently connected. 

The Omnis family of producLs has offered SQL database 
connectivity for Macintosh computers since Omnis 3 Plus version 
3.3 published in 1987. This long experience witli the needs of 
enterprise databases is rare on rlie Macintosh plattbrm. With 
roots going back 10 its first incarnation in 1979, Omnis i.s indeed 
a mature technology. 

Today, Omnis Studio for Mac OS X .ships with DAMs for 
Oracle, Syl>ase, MySQL (r:ommert:ial version only at MySQL’s 
request), OD13C (the native DAM for MicnjsoIVs SQI* Server, bui 
a general purpose DAM for other databases) and [DBC. 
FroniBase and OpenBase have also created their owji DAMs to 
allow Omnis Studio to lie front ends for them as mentionetl 
earlier On other platforms, Omnis Studio ships with tfiese DAMs 
as well as DAMs for DB2 and Informix. There is even a special 
version of Omnis Studio lor SAP that is core certified (meaning 
that applications developed for SAP using tliis version of Omnis 
Studio are automaticaUy certified, saving the developer 
significant time and currency!). Sliould any of these database 
server products choose to appear on Mac OS X in the future, 
Omnis Studio will he ready for them. 

But how does this work 10 our advantage as programmers 
and consultants? Let's |>erform a little exj)eriment to illustrate the 
power of the DAM,.* 

A Hands-On Experiment 

Suppose thai we have just been given the task of 
transferring data from one data I rase product to an£)tlier, We have 
existing data being managed in OpenBase and someone 
sotiiewlicre in our company has decided that we will now 
switch to FrontBase. (In reality, it could just as easily take place 
the other way around. It just so happens that a number of 
example dauibases are installed with OpenBase and not witli 
FroniBase, so we don’t have to build or install anything extra to 
perform our experiment,,.) 

Of course, to perform this experiment and prove to yourself 
tliat it works as described in this ankle, you will need to have 


tlie right tools at your disptxsal. Fonunately, we have chosen 
software tliat is available for free (at least for evaluatkai and/or 
development purposes), so all you need to do is put in some 
time and effort to download, install and license them. And it will 
be woitli the effort, !x:cause we will use these programs for 
exercises in future articles as well. 

There is no rexxm in this anicle to guide you through the 
installation of diesc software pac:kages, but we can point you in 
the right direction. The installation process for each product is 
tjLiite simple (this is all on Mac OS X, after all), so the 
manufacturers' instructions should .see you through. Web 
addresses for each of these companies are given at the end of 
this anicle. 

We also provide some additional setup information that you 
will need once you have installed ihe software. Again, ,space is 
a limited resource in print publications, so we must send you to 
the Web for this auxiliary information. Ihere we walk you 
ihrtJugh the proccs.s of accjuiring, installing and licensing these 
packages, starting the proper OpenBase database for iIk* 
exercise in this anicle, creating a new empty database in 
FrontBase lhat will become a clone of the OpenBa.se tktiabase in 
our experiment and creating ses.sion tern [plates in Omnis Studio 
lhat generically define access channels to OpenBase and 
FrontBa,sc, wluch we will u,se as a basis for defining more 
specific channels for the exercises in this and sulisec^uent 
aiTicles. ’flie notes yoifll need are at: 

http://www.daviclswa‘rn.cQmymaaech0305swinstall.html 

But whether you go off and prepare to perform this 
experiment for yourself or you just read through the example in 
a comforlalile ea.sy chair, Fm certain ytju’ll tK^giii lo see the 
power and simplicity of this impressive tool! 

SQL Browser Basics 

For this experiment, we only need to use a utility built into 
Omnis Studio. We don’t need 10 do any aciual prograinining this 
lime, although we will execute a couple of lines of code from 
an SQL command Ime to solve some problems we will 
encounter in the next i.s.suc* On the other hand, ii is importanl 
that you know that the Omnis Studio Integrated Development 
Environment (IDE) is, in fact, built using the programming 
features of Omnis Studio iiself - ,sc) a compeient Omnis 
programmer couki build any part of tills utility. 

The steps and iliustratioas shown liere are for the 3-3.3 
veraion of Omnis Studio. Version 4.x streamlines this and related 
processes through the use of an integrated browser, so we don’t 
have to open so many windows (like the Mac OS X finder) when 
drilling down into deeper levels of the process. If you own a 
copy of Omnis Studio version TO.2, you ,should have no Iroulrle 
following along. 

To summarise what was done in the Web exercises, we have 
a datalrase named Company running in OpenBase, Tlie user for 
this database i,s admin and there is no password, Tliis example 
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datai>a,st! wd5 installed with our copy of OpenBase, We created a 
new (and, therefore, empty) database with The same name in 
hrontBase, w'hich automatically began running upon creation. 
The default user for ihai datalxise Ls_system and again there is 
no password. Tlie OpenBase and iTontUase DAMs are both 
nestled snugly in tlieir appropriate locations so Omnis Studio has 
access to them. We are now ready It) launcli Ornnis Studio. 

After doing so, we must navigate to tlie SQL Browser utility. 
We open the SQL Browser in Omnis Studio 3-x by selecting 
Tools>SQL Browser... fn>m the main menu bar. The SQL Object 
Browser window shown here then ap|>ears: 
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Figure 1. Omnis Studio S.x SQL Object Browser Window 

In Omnis Saidio 4.x, the SQL Browser is integrated into the 
same window as the other browsers of the IDE and the window 
iLself confonns to the Mac OS X standard of tools-only, no 
embedded menu bar. 'Hie Browser window opens w^ben we first 
launch that version of Omnis Studio. Rut if it clo.ses, we can 
open it again using View>Browser... from the main menu bar or 
simply by pressing Command-2. 'llien enter the SQL Browser by 
selecting the item with that name from the hierarchical tree list 
on the left side of the window. 

Tlie SQL Browser allows us to poke around in SQL 
databases for wliich we know valid usernames and passwords. 
We can also perform certain utility functions and move structural 
infonnation between the table definitions in existing databases 
and Omnis Studio Schema, 'fable and Query Classes in an 
application library. All of the.se are Mrhjects for other times. Riglu 
now we need to establish a .session to eadi of our databases 
using our two DAMs so that we can manually interact witli them. 

In the online setup exercises, we created generic .session 
templates for each of our SQL platforms. We will now duplicate 
each of these templates to create session objects that point to 
specific databases. OpenBase and FrontBase have their own 
ways of specifying login information, but we can use the 
appropriate syntax for each product in the fields of tlie Session 
Editor windows We get there by choosing Session> Modify Session 
Templates... from the menu bar embedded in the SQL Object 
Browser window. TliLs opens the Session Template Manager window. 


The mechanics of what follows assumes the reader has 
performed the setup exercises, !)ui the flow of the proc:ess 
should make .sen.se whetfier or not ifie exercises have been 
followed to this ix>int, 

First, well duplicate the OpenBase generic template and 
open the duplicate .session objecL Since it Is already set up to 
use the OpenBase DAM, we only have to specify information 
about the databme we want to access. When logging on to an 
OpenBase database, we must specily the path to the database 
using liic .synuix <databa5ename>@<hostname>. So we will use 
Company@!ocalhost here. We also know that the user whose 
account we w^ant to use is admin and that thi.s user does not 
have a password. We will also use tlie name OBCompany for this 
session. Our form should tlien look Like tlie following figure: 
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Figure 2. Session Definition for Company on OpenBase 

Now we need to create a similar tetnplate to access the 
Company database running on FrontBase. Be.side.s using a 
different name for this connection, notice tliat we need to use a 
different login syntax for FrontBase. It uses 
<hf>stname>/<databasename>, so we must enter localhost/Company. 
Also, we have a different user (who is still not using a 
password!), so we must enter this differently as well. Your 
template should look like this before accepting it: 
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Figure 3. Session Definition for Company on FrontBase 

Now leils clo.so the Session Template Manager and return to the 
main SQL Browser view so we can actually connect to our 
databases. In Omnis Studio version 3 3.3, just close die Session 
Template Manager window. In Omnis Studio 4.x, just click die Back 
button in the navigation list. 
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Opening a Channel 

Assuming thai wc specified all the correct infi)rmalion, 
opening a session to each database is a very simple process. 
The name of any complete session templale will appear in the 
Open submenu of tlic Session menu of the SQL Object Browser 
window when it is seleaed. We open a session io a specific 
dataljase by selecting the name we gave to tlial session template 
from this submenu. 
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Figure 4. Opening a Session Using a Session Template 

An icon appears in ihLs window for each open session. 
When Ixxh of our sessions are open, the window should kK)k 
like this: 


Figure 6. Stnicture Category View for 
Company on OpenBase 

If wc want to see the tables (and ultimately die data in those 
tables) in our database, we just double-click on the Tables icon in 
this view to expose tile Tables view. 
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Figure 5. Open Sessions for FrontBase and OpenBase 

Browsing Existing Data and Structures 

We can drill down into a session to see more infonriaticjn 
by simply double-clicking on a session icon. This opens a 
stmclurc category view. 
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Figure 7. Tables for Company on OpenBase 

Here we see that our Company daial>asc contains eleven 
tables. So far we haven't seen anycliing that canT be done in 
the Manager programs for either SQL prodiid. Bui from liere 
we can do a number of useful things on die Application side 
of the equation. 

her example, we could drag one or all of these tables to our 
Omnis Studio application lil^rary to create ecjuivalent table 
structures in the application. The DAM used to set up the 
connection determines wliicl; Omnis Studio data typet majxs 
properly to eadi column in die SQL database. Tliese facilities 
come in really liandy for our conversion exercise! 

If we prefer to view the tallies in tlie database as a list rattier 
than as an array of icons, we can change to the Details view 
using die View menu of the window. This applies to any of tlie 
browser windows we have already encountered. 


kVCnCH 


Enkbprise Database TtcHNOiocv 21 





















































OBCOMPANY^Tables 


Session Object Tools 




A *€1 ^ 

§ « 


View 

✓ Large Icons 
Small Icons 


Up One Level 
Down One Level 


contaas company cal 11 


Show 


Figure 8. Switching Modes in a Browser Window 


OK, we’ve looked artmnd the facilities a hit. Let's get down 
lo cionverting that data! 

Converting Data 

We need to drill down to the Tables view level for both 
databases to perfonn our transfer from one to the other Once 
we have done tliat, it's simply a mailer of drag-and-drop - if all 
g(x:.s well. Follow along closely I^ecause we will gel inlo a little 
bit of tronble once weVe traversed the smooth water... 

First, we will do an easy one. Place the Tabte view windows 
for onr two databases so they can botli be clearly seen and drag 
the company table from OBCompany to FBCompany. 


We can view either the column structure of the data in a 
given table. To view this structure, we just double-click on a 
table icon or rhe line in our list view for dial talile. 

If wc instead want to view the data for dial table, we can 
use the Show Data,., iieni from the context menu for that uible. 
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Figure 11. Drag company Table to FBCompany Session 

A dialog will appear asking whether we want to transfer ix)tli 
the structure and the data. TTiis is exactly what we want to do, so 
we just click the OK button or press die Return key to accept. 

SQL Transfer From Session OBCOMPANY to FBCOMPANY 


Figure 9. Show Data for company Table in 
Company Database 


Tliis opens the Interactive SQL window with a [Ke-built 
query lo select all cokimns and all rccords for the selected table. 
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Figure 10- interactive SQL Window with All Records for 
company Table 

Of course, if our table contains millitms of records, this may 
not he a gcxxl idea. But we can access this window in other 
ways and type in a more reasonable query for large tables. This 
is our SQL commarid tine and we can use to for a numi:>er of 
purp<ises “ including repairing data tliat won't ininsfer from one 
database to another. 
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Figure 12. SQL Transfer Dialog 

Wc are then asked to verify the column structure wc wish 
to create in the new table for the target database, TTiis is our 
opportunity to make any adjustments. We want an exact 
duplicate in this case, so we again accept by clicking OK. 
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Figure 13. Destination Table Structure Verification Dialog 
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If there are no probiems, Oinni-s Studio Ursi creates a new 
table in Lite Ctjmpany datal)asc and then begins to transfer all 
existing records, A dialog with a progress bar appears, indicating 
that data is now being transferred. 

After the data has been transferred, another dialog ap(?ears 
asking us to verify the indexes for the target table. If we see no 
problems, we again accept. 
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Figure 14. Index Verification Dialog 


J r r ' - V _ 1 MiJkJ T. ^ 


S€S5ion Object Toots View 

^ Sfission Dbji 

® # S -Si? # O “a ^ 


^ 8 6 






Object owner 

piripaiiv 

contacts 

company 




iiustomPopUps 

ojstomTittes 

groups 

■ategory 

orderttems 

orders 

products 


1 

TrartsacTlons 



V>^ ot >A 1 isi J 

pbiKt OperatiMYf 


After all this activity (mostly on the part of Oinnis Studio), 
we see our completed table now appears In tlie Tables view for 
FBCompany. Go ahead and view the data for tliis table to verify 
that it was transferred, 
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Figure 15. Completed Transfer of company Table 

Tliat was certainly easy! But we can do better than this. We 
can select muMipie tables from the source database and transfer 
them to the tatget database in a single process. Follow along and 
give it a iry. Perform these steps precisely, though, because ITti 
avoiding known pmblems that we wQl address and solve in the 
next iSvSue... 

Select all the tables in OBCompany from call History to products 
by dragging across tliem in the list, Tlien drag the wTiole lot of 
them to the FBCompany table window. 
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Figure 16. Drag Multiple Tables to FBCompany Session 

The dialogs detailed alxjve will open for each uible in 
.succession. Just accept each one. There should not be any 
problems witli any of them. Notice that the user is still needed 
to make decisions and accept dialogs along the way, but there 
are few, if any, difficult decision.s to make as long as tlie data 
and structure from one database is compatible with the other. 

But there can be issues,.. 

Dealing With Conversion Problems 

Next time we will tackle a couple of tables with conversion 
problems and see how Omnis Studio makes short work of them. 
Try dragging tlie transactions table from OBCompany to FBCompany 
and watch what happens. It all begins pleasantly enough, just 
like the others did. The table structure looks fine and die data 
tx:gins to traasfer and then Bang! An enor message appears part 
way through the data transfer! This is not a major problem, but 
weVe run our of space to solve it this month, (Extra points for 
Lhe people who solve tliis before they see the next article - and 
double extra points if you also solve the issues with the contacts 
table unaided!) 

Conclusion 

We have now performed a successful conversion of both 
table structures and data from one database to another for a 
number of tables. We did not have to export the data from 
each table into tab-deliroited file, massage that data in 
spreadsheets to put it into the proper format for import or 
manually import it into the target database. We just dragged 
table images from one window to another. If there was a 
problem, the utility told us about die problem and then rolled 
liack the transaction (staicture and data transfers were 
separate transactions) so that we wouldn’t have to deal witli 
the additional headache of partial transfers. The utility also 
provides tools that allow us to solve what problems do arise -- 
which we wall explore in the next article. 
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Pretty cool! 

what did we learn from all of this? 

First, we learned that not all SQL database products ate 
created ecjually. This does not necessarily make one intrinsically 
better or worse than anotJier, but it gives enterj>risc consumers 
a choice. 

Second, we saw some common data conversion problems 
tliat can occur in real-life situatioas and we experienced 
potential solutions to those problems. We also had a chance to 
work with a useful utility in a sopliisticated application 
development tool that gave us avenues for solving such 
problems. 

Finally, we found our that there is a lot to learn if we want 
to successful in llie enterprise environment. There are new 
concepts and new toots to master in the process. But we learned 
that our favorite openitiag system pLitfbrm is more than ready 
to enter die enterprise daUiba.se marketplace. And it c'an do so 
proudly and effectively. 

Useful Web Sites 

You may wish to further explore some of tlie producLs and 
technologies mentioned in this article. Here are web links to 
sites for a number of companies who create SQL database 
products and related software: 

FrontBase, www.frontbase.com 

OpenBase, www.openbasexom 

Oracle, www.oraclecom 


FirstSQL, www.firstsqLcom 

MySQL, www.mysqLcom 

PostgreSqL www,postgresql.org 

Omnis Studio, www,omnis.net/mactech 

Actual Technologies, www.actualtechnologies.com 

Bihltography and References 

You may wish to brush up on your SQL skilLs as well. You 
may need tliem for the rest of this article series. Here are a 
couple of lxx>ks you may find useful: 

Date^ C. J. and Darwen, Hugh A Guide to the SQL. Standard. 
4th edn. Addison-Wesley, 2000. 

Taylor, Allen G. SQL for Dummies. 5th edn. IDG Books 
Worldwide, 2003. 
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APPLESCRIPT ESSENTIALS • by Benjamin S. Watdie 


Performing Basic 
Image Manipoution... 

Using Your Existing Software! 


Wliilc ihis concept seems amazing 
at first, you quickly realize that you 
now have thousands and thousands of 
image files to deal with, lliose image 
files need to be downloaded, imported, 
renamed, filed, rotated, cropped, 
converted to other foninats, and more! 
Sure, there are some ttx>h that Apple 
gives us to help with these tasks, such 
as Image Capture and iPhoUh There 
are also a slew of other applications 
that you can download or purchase to 
aid with processing. However, 
wouldn't it be great if you could slap a 
few lines of ccxle together to write your 
own application in order to help with 
your unique process? Well, using 
Ap(>lcScripL, you can. 

AppleScript is the perfetl tool for 
automating many image-related tasks. 
As we have discussed in previous 
articles, AppleScript can be used to 
batch-rename files and folders. So, 
you could create a script that 
downloads your digital images into a 
custom folder structure and renames 
the images with the current date. You 
could create a script that opens up a 
folder of images in something like 
Photoshop and adds copyright 


informal ion into the images* metadata. The possibilities 
arc virtually limitless. 

For this particular article, weVe going to focus on 
perfi)nning some basic image manipulations, such as 
cropping, rotating, and resizing. Wcdl also ItK)k at ways 
you can convert your images to other formats, such as 
frf>m JPBG to TIFF, and vice versa. Since AppleScript 
altjne cannot manipulate images, you may be asking how 
will we do tliis? Using a background application named 
Image liwnts, which c:omes installed with Mac OS X, 
version 10.3 and higher, we can perform these tasks. 

Image Events 

Mac OS X, version 10.3 and higher comes with a 
Iiackground apt^lication called ImagePtJents, which can lx; 
found in the System > Lthrafy^ > CoreSen/ices folder on 
your iiard drive. 

For those using Mac OS X, version 10.2, an application 
named Image Capture Scripting will allow you to 
perform a few of the same tasks that will be discussed 
in this article. Image Capture Scripting ctan lx found in 
tfie System > Library > Scripting Additions folder on your 
hard drive. 

'Ihe image Eienis applicalicm can be used in conjunction with 
AppleScript to interact with a service in Mac OS X called SIPS, or 
Scriptal>le Image Processing Server Ihis service allow.s basic image 
manipulations, such as cTopptng and resizing to take place. 
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T his month, we're going to talk about performing some basic image 
manipulations with AppleScript. With the onset of tlie digital camera 
revolution comes a new set of problems for the computer user. The 
first thing many people realize after purchasing a digital camera is tliat film 
is essentially free, as is developing. You can take as many pictures as you 
like, just as long as you have ample hard drive space to store them. 


Accessing the image Events Dictionary 

Tn order Lo begin antoiiiating Image Emmt^ with 
Ap[)leScript, the first thing you will want to do is open the 
Image Ewnts AppleScript dictionary. This can l>e done by 
launching the Script Editor, and tlien selecting Image 
Events and clicking the Dictionary icon in the Library 
palette. U the Library palette is not visil>le, you can 
display it by selecting t!ie Window > Libraty menu. You 
may also open die Image Events dictionary by selecting 
File > Opmt Dictionary... in the Script Editor. 


Figure 1. The Image Events AppleScript Dictionaiy 

Once the Image Events dictionary has been opened, 
you will notice several suites of classes and commands 
in the IcfL-hand pane. Some of these can be ignored. 
Por example, you won't need to use the Text Suite and 
you iiKty not need to use the Disk-Foider-FUe Suite. You 
will need to accejks a few commands in the Standard 
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Suite, such as open and quit. You will also want to 
access most of the classes and commands in the Image 
Suite, which contains all of the commands for actually 
performing image manipulations. The Image Events 
Suite contains some Image Events application 
properties, winch you may want to modify, but T will 
not be covering them in this article. 

Opening an Image 

First, when working with Image EvenLs, you need lo 
make sure that the application is running. This is done 
with the launch command. For examplet 

tell application "Tmage Events” 
launch 
end tell 

Obviously, the next step in creating a script that will 
manipulate an image is to open an image. This is done 
by passing the image palli lo the Open command. For 
example, the following sample code opens a JPEG image. 

set the Image to choose file of type ‘‘JPEG” 
tell application “Image Events” 
launch 

open thelmage 
end tell 

—> image “imageName,jpg" of application "Tmage 
Events” 

As you can see in the above example, the open 
command returns a reference to the opened image. 

Accessing Properties of an Image 

Once an image has been opened in Itrmge Events, 
you may access certain properties of diat im;^ge, such as 
the resolution, or the dimensions of the image. For 
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example, the following sample code gets the resolution of 
a JPEG image. 

set thelmage to choose file of type “JPEG" 
tell applicatloti ‘‘laage Events’* 
launch 

set thelmsgeReferenee to open thelmage 
tell thelmageReferencG 
reaolutioa 
end tell 
end tell 

-> { 180 . 0 * 180 * 0 ) 

ITiis is just one example of an ima^e pK)pe!ty that can 
be retrieved with AppleScript. I encourage you to explore 
the other AppleScript-accessible image properties, which 
can be found under tlie image class in the image Suite of 
the Image Himits diaionary. One tiling to note, though, ts 
llial all of these accessible properties are currently read/only 
properties. They amnoL be changed with AppleScript. 

Performing Image Manipulations 

image Events gives you the ability to pejibrm a variety 
of basic image manipulations, including cropping, 
flipping, padding (i.e. adding a border around), rotating, 
and scaling. The commands for performing these, and 
other, image manipulations can \ye ft>und untier image 
Suite in the Image dictionary. Let's take a kK)k at 

one of these commands. 

The example ct^de lieiow shows bow to scale a J PEG 
image to a maximum height or width, based on the 
image's longest side. Please take note chat in order to 
aaually see the sealed image, you must save the image 
after it has been manipulated. This is done by using the 
save command. You may also wajit to close the image 
using Uic close command. 

set thelmage to choose file of type “JPEG" 
nell application “Image Events" 
launch 

set thelmageReference to open thelmage 
tell thelmageReference 
scale to size 100 
save 
close 
end tell 
end tell 

One thing to note is, by using the save command 
in the manner above, the image you opened will be 
overwritten with the newly scaled image. If yt)u want 
to save the new'ly scaled image in another location, you 
may optionally specify a save path. 

set thcTinage to choose file of type "JPEG" 
set theOutputFclder to choose folder 
tell application “Image Events" 
launch 

sex xhelmageReference to open thelmage 
tell thelmageReference 
scale to size 100 

save in CthoOutputFolder as string) & “Scaled 
Image.Jpg" 
close 
end tell 
end tell 


Let's take a look at one more type of image 
manipulation. ITie following example code will flip an 
image horizontally, and save it into a separate folder. 

set thelmage to choose file of type “JPEG" 
set theOutputFolder to choose folder 
tell application "Image Events" 
launch 

set thelmageReference to open thelmage 
tell thelmageReference 
flip with horizontal 

save in ttheOutputFolder as string) & "Flipped 
Imege.jpg" 
close 
end tell 
end tell 


Performing Image Conversions 

Wlien working with images, it frequently Ijecomes 
necessary to convert images frt)m one iormat to another. 
Sure, you could open a JPEG image in Pretieuf, and manually 
export it to TIFF ibnmat. But, what if you needed to do this 
to 100 images, or 1000? Tliis type of process can actuaily be 
done with AppleScript and Image Events. 

Earlier, we discussed using the save command to 
save images once they have been manipulated. Well, the 
save command also some opiional parameters, one of 
which allows you to specify a file type in which to save 
the image. The hallowing example code demonstrates 
how to convert a file frcmi JPEG to TIFF formal. 

set thcImagG to choo^^ File of type "JPEG*' 
set theOutputFolder to choose folder 
tell application "Image Events" 
launch 

set thelmageReference to open thelmage 
tell thelmageReference 

save In (theOutputFolder as string) ^ “Converted 
Image.tiff" as TIFF 

close 
end tell 
end tell 

ImageEmnis supports saving images in the following 
formats - BMP, JPEG, JPEG2, PICT, PNG, PSD, QuickTime 
Image. And TIFF. While Image Events can open GIF, 
MacPaint, PDF, SGI, and TGA image.s, it cannol save in 
these formats. 

Pulling it Together 

Now, let's pull togeilier a few of the tasks we have 
discussed. Tlie following example code uses a repeat 
lo procress a folder c^f JPEG images. Using Image Events, 
each image is opened, resized, and .saved in TIFF formal to 
an output folder. 

set thelmageFolder to choose folder with prompt 
“Select a folder of JPEG Images:" 
set theOutputFolder to choose folder with prompt 
"Select an output folder;" 

tell application “Finder" 

set thelmages to every file of thelmageFolder 
whose file type - “JPEG" 
end tell 
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tsll application “Image Events"" 
launch 

repeat with a from 1 to length of theImages 

set theltaage to file CCitem a of thelmages) as 
string) 

set thelmageReference to open thelmage 
tell thelmageReference 
set thelmageMame to name 
save in C{theOutputFolder as string) & 
theTmageName L ".tiff**) as TIFF 
end tell 
end repeat 
end tell 


Other Image Manipulation Tools 

As you niay already know, there are some other image 
manipulation tools available. BolJi Graphic ConlH^r^er 
<http://wwwJemke5oft-corn/> and Adobe Photoshop 
<http://www.adobexom/products/photoshop/> offer extensive 
AppleScript support. By using Apple5k:ripl to automate 
applications such as Uiese, you can create simple to complex 
automated workflows in order to perform virtually any type 
of image manipulation or conversion pnxress imaginable. 

In Closing 

Tliroughoiit this article, we have discussed some basic 
ways to go about manipulating images in Mac OS X using 
Image Events. While wc looked at a few examples, as 1 
mentioned earlier, there are many other image 
manipulation commands and image properties dial are 


available within die Image Eveftts dictionary, that we did 
not have a cliance to cover, llie examples in this article 
only scratch the surface, and are meant to show you some 
basic ideas of what is possible. 1 would encourage you to 
Ix^gin exploring die Image Events dictionary in greater 
detail, so that you can begin using this application to its 
fun potential, making your own workflow more efficient. 

For sc^mc additional information about Image 
Events^ please visit Apple's AppleScript web site 
http://www.apple.com/appiescr1pt/innageevents/ 

Until next lime, keep scripdng! 

Til I 
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QUICKTIME TOOLKIT • by Tim Monroe 


The Incredibles 

Recommending QuickTime 
Programming Books 


Introduction 

One t)f the first questions that new 
QuickTime programmers ask — or .^hoidd ask 
— is this: “Where do I get started?" Usually this 
means: "Where can 1 find some good 
docLimenUition on programming Quick'rime?” 
Almost without exception, the most uj>dc)-date 
and most authoritative information is to t>e 
found on the Quic:kTime developer web pages, 
starting at http://developerapple-com/quicktime. That 
page contains links to the latest on-line 
documentation, siimple code, technical notes, 
and related materials such as QuickTime t(x>ls 
and information alx)ut the Apple-sponsored 
user- and API-level mailing lists. 

The documentation links can be 
particularly daunting for newbies, however 
There are links to over fifty separate 
documenLs (available in lx)th HTML and PDF 
formats), which range from introductory 
overviews to highly-specific discussions of 
each major area of QuickTime progmmming, 
including sprites, movie importers and 
exporters, QuickTime VK, movie capture and 
compression, and so forth. There are also 
documents that a.ssisi in developing QuickTime 
applicTitions in Cocoa or on Windows. So 
where sliould we begin if we want to write an 
image capture applicalitm in Ctx’oa? With the 
c:aptiire documentation? With the introductory 
documenLs? With the Cocoa documentation? Or 
suppose we wanted to write the application in 
Java instead; is there a good tuttjrial on 
capturing .sound and video data using 
QuickTime for Java? 

1 dunno; or radier, I didn'mo until I got 
ahold of a copy of a new book in the O'Eeilly 
Developer's Noiehook series, QuickTime for 


A Det^loper s Notebook l>y Cltris Adamson, fn that book, 
Chris shows how to develop a Java application that captures 
video and sound data from, for example, an iSight camera. 
WliaFs ama:^iog alx>ui this is ihai Apple has explicitly claimed 
not to support sequence grabbing in QuickTime for Java versions 
6.1 and later (while tantalizing us with the suggestion that “it may 
l)e provided in future releases”). Chri.s figured out the magic 
necessary to get things to work and delivers a working Java- 
baseti capture tool. Very nice. Whads even nicer is ilxit die entire 
lxx)k LS a tlioroughly readable tutorial on using Java to develop 
QuickTime applicidons. 

'llie excellence of Chris* book set me to thinking alxiut the 
general state t>f QuickTime programming Ixxaks. If our imagined 
ncwljje wanted some recommendations on paper-and-glue 
books to hold in her hands and peruse fn>m die siifety of her 
annehair, what could we offer? In this aiticie, I w;mt to 
recommend five fxxiks on QuickTime and Quick^fime 
applic'ations development. Weighing in at more ilian 2600 pages 
total, 1 doubt that even the most persistent newbie would slog 
though diem all lx.Tore launching into a programming projea. 
But, in my opinion, diese are some of die Ix^si sijurces of 
informatifin available to QuickT'ime programmers today. 

Disclaimer. \ wrote two of these books, and 1 assisted in 
reviewing several others. I know all the authors personally, and 
I have the greatest respect for each of them. However, I have no 
financial .stake in any of these publications. You can purchase a 
zillion copies of each of these Ixxjks without fear that you are 
contributing to my retirement fund. 

(luickTime for the Web 

Quicklime for the Web by Steven Gulie is easily the most 
misnained book in iliLs Ixmch (or in just about any other bunch). 
From tlie sound of tlie tide, you miglii Lliink tfiat it was ainxxl at 
Internet-sawy webmeisters looking to optimize delivery of their 
wcli-Ixused QuickTime movies. Indeed, the sulxide of die first 
edition was "A Hands-On Guide for Webmasters, Site Designers, 
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O ne of the first questions that new QuickTime programmers ask 
— or should ask — is this; “Where do I get started?” Usually 
this means: “Where can I find some good documentation on 
programming QuickTime?” 


and HTMl- AuUiors'’. Thankfully, llic puhiislicr drupfxxl lliat subtitle 
in following editions, Tliis lxx>k, tliough it does of course discuss 
issues involved with deploying Quick! inie content on fhe weh, is 
much more general and useful. It is, quite simply, llie Ix^st availalde 
intn)dut:tion io QuickTime as a muldmedm technology. It explains 
in great detail the many, varied parts of the Quicklime arcliitecaire, 
from video and sound to QuickTime VK to sprites and wired actions. 
To SMIL. To Flash. To ^il\ images. To text movies. And I)eyond. 



QuickTime 
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QuickTime for the Web 


QuickTime Toolkit 

ITe two QuickTime T<x)lkit LxK>ks, whidi I wrote, grew out 
of articles that apj^ared in MacTech magazine from 2000 to 2003. 
in fact, this series of articles was originally planned precisely to 
allow the easy transition from magazine to book form. Tfiose 
ixxiks present, in niy opinion, the most complete and most 
accessible general introduction to Quick'rime programming chat 
is available today. They als<s conUun a fair amtjunt of previously 
undcx'uincnted material that lias come in handy over the years. 



Now, this is not primarily a prognimming Ixxik. It does at one 
point show how to use JavaStTipt to control QuickTime movies 
playing back in a bnjwser windt>w, l>ut it’s not by any means an 
API-ievel investigation of QuickTime. So why am I recommending 
it to our newbie Quick'rime programmer? Simply Ixxause a 
thorough understanding of the QuickTime archiieclure Ls cssentiaJ 
for making intelligent decisions alx)ut the design and 
implementation of Quickl ime applications. Time and again 1 Mve 
seen developers (and not just rmk newbies) ovcrkx>k easy .solutions 
lliat would Iiave been more obvious liad tliey liad a broader view 
of the scope of Quicklime and Quicklime movies. Steve's book 
provides that brT:>ad view and deserves to lie the first stop on any 
pnispeaive QiiickTime piograrnnier’s reading list 


QuickTime Toolkit, Volume One 

Tie first book, QuickTin^e Toolkit, Volume One: Basic Movie 
Phyl:}ack and Media I'ypes, begins by showing him to use 
Quic:kTime funciion.s to open and display a movie in a window on 
tlie screen. It also shows how to perform basic editing operations 
on a movie and how to save an edited movie into a file. This Ixiok 
tlien shows liow to work with a variety of media types, including 
video, still images, text, timecode, and sprites. It introduces 
concepts diat are fundamental to QuickTime programming: 
movies, trac:ks, media, time soles, track references, atoins, atom 
cT)niaincFS, data references, media samples, sample descriptions, 
and a hast of others. Tliis first book ends with an in-depth look at 
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one of the cornerstones of QuickTime interactivit)'; wired actions 
and wired sprites. 
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QuickTime Toolkit Volume Two 

The second book in this series, Quicklime Tooikit, 
Volume Two: Advanced Movie Flayhack and Media Types, 
continues this joumey by looking at a handful of the more 
advanced media types supported by QuickTime: video 
effects, skins, Flash, and Quick*rime VK. It shows how to 
capture movies frt)m sound and video input sources, 
broadcast movies to the Internet or a LAN, play movies full 
screen, and load movies asynchronously. Together, these two 
books present a detailed narrative that covers a substantia] 
amount of what’s involved in QuickTime application 
programming on both Macintosh and Windows computers. 

Both of these books present example code using the C 
prtjgramming language and reflect whal we now^ call the 
‘"Carbon” programming model If you are programming in 
REALbasic, or Revolution, or Java, or Cocoa, or any other non- 
C language, then you1l need to Itxjk elsewhere h>r introductory 
material geared to developing QuickTime applications in your 
panicular development environment. However, chances are that 
the basic algorithms presented in these books can be 
transferred fairly easily to other languages. More than once, for 
instance, Tve taken code from these books and reworked it to 
run in a Cocoa application. And, of course, over the past year 
and a half, weVe had the oppoituniry to play with a number of 
these alternative development languages and tools in tliis 
column in MacTech, 

Interactive QuickTime 

Matthew Peterson is a recognized master of Quicklime’s 
intemaive capaliilities — partiLularly of wired sprites and wined 
actions. IVe seen audiences in awe over tlie amazing tilings he has 
done building intelligent, active QuickTime monies. Movies that read 
data off a remote server and chart giaphs in real time. Movies that 
look and act like a p(x:ket c^ilculatoi: Movies that track the mou.se 
and alter the appearance and location of objects in the movie based 
on mou.se movements* Movies that simply knock your socks off, no 
matter how long youVe worked with QuickTime. 


Interactive QuickTime 

Interactive QuickTime is Matthew's eagerly-awaited 
explanaiitin of how he does srime of those amazing things. He 
guides us deftly tlirough QuickTime's interactive landscape, 
discussing how to add dynamic, active behaviors to sprites, video, 
text tnicks, Flash, QuickTime VR, and movie tracks. He also covers 
the ttiuch-ncglccLcd topic of coitiTTiunicaiing with servers using 
QTLists. Ihis book is chock-hill of usehil algoritiuiis and 
interesting approaches to programming interactive behaviors in 
Quic:kTinic movies. 

Tlie exiinipies in tills book are almost exclusively presented in 
QScript, a scripting binguage suppoited by the LiveStage Pro 
apptkraiion. To get the mexst out of this Ixxik, therefore, you need 
to have tlmt Rxxl available, and indeed the CD induded with llie 
Ixxxk provides a demo version of LiveStage Pro. I can attest from 
long experience that building intemaive movie using raw C code 
can be a painful prtx:ess. Nonetheless, the algorithms themselves 
are dear enougli that you could easily reimplement tliem in C or 
any other higli-level language, 

QuickTime for Java^”: A 
Developer’s Notebook 

1 know' wliat you are tliinking: i don’t do Java; I liave no 
interest in doing Java; so tliis Ixxak is not for me.” Fair enough. At 
least let me say tills: if you do program in Javu and you are 
interested in developing QuickTime applications, tiien QuickTime 
for jam^: A Deadopers Noteboc^ by CJiris Adamson (O’Reilly, 
2005) should lie on your lioolcsheR. Better yet, it should be propped 
open on your desk as you work your way though it. WeVe already 
seen liinis of tlie kind txf careful analysis Clirls iiriiigs to tiie table iri 
iiis ability to get QuickTime for Java applications to capture video 
and audio sourcres. He shows that same in,sight throughout this slim 
volume, denitmstrating how to open and display still images and 
QuickTime movies, support movie editing and undo operations, 
export movies and still images, build movies from raw data, and 
w^ork with the QuickTime video effects architecture. All in Java, and 
all skillfully integrated with tlie major Java windowing toolkits, AWT 
and Swing. 
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QuickTime For Java 


AcLually, hawe.vtr, 1 dispure the idea lliiit tlm Is a 
exclusively lor Java developers. In .several instances, Chris mxs out 
some cxxle that, miuatis could easily be useful to C 

programmers. In pailiaikrp he presents a careful diss<xtk>n of the 
fonmt of ilie metadata atutthed to f limes AAC files and shows how 
to construct a set of Java classes for reading and displaying the 
author, title, and album infomiittion (among otiicr kinds), I imagine 
it WQuid l)c easy to reimplement his algoritlim in C and hence make 
it more widely available. 

I do have one quibble witli Oils !xx)k. Tilts isn’t your typical 
O'Reilly lxK)k: there’s no animal on the cover and tlie editorial 
direction is much more ftx:LLsed These l^ei^eiciper's Notebooks are 
supposed to harness "the often-frantic scTil>l>ling and ntxcs that a 
true-[>lue alpha geek menuiUy makes when working wilfi a new 
language, APL or pn>jcct," The book design reflects tl^ “lab 


manuar approach: tlie fxagcs have a graph-paper ruled background 
and the cover shows tlie staias of a cofFec mug, Thai's all well and 
grxKl. Bui the l:>ook is printed with a bluLsh-puq^lLsli ink iliat is 
particularly unwclccjme for the screen shots and odier graplacs. Tlie 
text is perfecdy legible, to bc^ sure, but the images just look odd. It 
would have Ixien less jarring to stick with black ink, I think. 

Book Information 

B<x)ks in the Morgiin-Kiiutmaiin Quick'ijme 

Quick'Hmefi)r the Weh, by Steveti Giilie, Motgan-Kaufnxinn Cltiird 

Edition, July 2003 ). 825 pages, ISl^N: 1 - 55860 - 904 - 0 , 

QuickTime TooikU, Votume One Basic Movie Playback and Media 
7 )pt 5 f, by Ttm Montoe. Mtjrgan-Kaiitmann (First Edition, June 
2004). 640 pages. ISBN: 0 -i 2 - 088401 -L 

QuickTime ToalkU, Vohmw /to Advanced A^otie fHayhack and 
Metiia Types, by Tim Monroe. Mofg^in-Kaufh^n (First Edition, 
June 2(X)4). 528 pages. ISBN: 0-124)e8402-X: 

Inkmjciit^ QuickTime, l?y Matthew Peterson. Moigan-Kaufniann 
(Fiist Edition, Augcisi 2003)- 597 pages. ISBN: 1-55860-746-3. 

B(x>ks in tiie O'KeilJy iXwtiper's Not^jooks series: 

Qtiicklime for fatia, by Chris Adamsoa O'Reilly (First Edition, 
January 2005), 255 pages. ISBN: 0-5964)0822-8. 
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By Brad Belyeu 


Introduction 

l^et's say your working on a big project at tlie office. Of 
course, the project is saved on the fileserver for security and 
accessibility reasons. 'Flie big deadline is Friday at five, and you 
or one of your icain-niemlx^rs becomes deathly ill a couple days 
Ixfore. Or what if there was a blizzard? How in the world are 
you going to work on this proiect for your biggest client when 
you can't make it to tlie office? Create a virtual office! Using a 
virtual private network, you could access the network file, 
appliaition, & print servers just as if you were there. When you 
conned to a VPN, it apjxars as thougJi your computer sits right 
on tlie local network. Access is not as fast as piiysically being 
on the LAN, but when you can't be there it's the next best thing. 

Defining VPN 

VPNs (or Virtual Private Networks) come in many 
siiapes and sizes. It has been a buzzword that is fairly 
ambiguous and has taken on different meanings over 
time. VPNs provide .secure remote access to internal 
(private) networks over public networks, usually the 
Internet. Tlie problem in defining VPNs (las to do witla 
its ambiguity. Vimially all networks are virtual in some 
sense of the wi>rd. I don't have a direct cable connection 
to all die Inlernel resources I use on a daily basis. But I 


get to tliose resources through a public network, and they 
are often kxaled on someone else’s private network. 
Besides, what one person considers private is often not 
private enough for someone else. VPNs can't be defined 
f:iy any specific' soltware protocols because there are 
several different common protocols thai w'ork effectively, 

Vinual private networks can lie hardware or soltware 
based. Using Mac OS X Server or a software application 
like VPN Tracker Server allows you to create a software 
Vl^N server, hut most VPN servers are pieces of hardware 
external to your computer. VPN hardware is often 
included inside a firewall or router. For exiimple, 1 use 
die Linksys WRV54G, which is an Internet comiecdon- 
sharing router, wireless acce.ss point, Vl^N endpoint, & 
firewall all wrappc'd up in a single box. Cisco makes 
some very powerful VPN liardware for large netw’orks. 
Most software servers are created for a one to one 
connection using clienuserver based technology. 

There arc two main types of VPNs and 1 will define 
them by die endpoints they connect. Tlic first is the client 
to lj\N (local area network) connection. A local area 
network is your private internal network. You normally 
use this connection for remote users to comiea to a 
single office from anywhere with Internet access. This is 
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useful for teleconiniutiiig. If you have empltjyecs ihai 
worlv in the field bur need access to office databases, this 
is die type of VPN that you need, 'ITie other VPN type is 
LAN CO LAN, Tills VTN type is usuaUy used to conjiea the 
resources ai two office locations so they look like a 
single LAN, This Is often used when a company has a 
corporate location and other locations that need access 
to the corporate resources, or wlien resources are 
distributed across a couple of locations. 

But Why? 

When companies wanted to connect different office 
locations together before the Internet was widespread, 
they normally had to lease lines from a cable company to 
connect the ItK.altons* This kind of a network Is referred 
to as a trusted VPN. This wa,s a secure way m build a 
nem^ork since no one outside the buildings had access to 
the network as long as the cable company protected their 
switches, but it was also a vcr>' expensive way to slut re 
resources. With the advancement of the hilemel, it 
liecame c lear that using pubhc lines instead of [iiivately 
leased lines could connect officCsS much less expensively. 
But could a netw'ork over public lines be trusted fur 
private (secure) communication? Because of the need to 
protect data, secure VPNs were developed. .Secure VPNs 
use network prococols to encrypt data as ii leaves the 
originating network and then decrypt it when it arrives at 
its destination. If you are using a t:ombinaiion {>f both 
misted and secure VPN teclinotugy, it is referred to as a 
hybrid WN, 

VPN Protocols 

PPP (poinHo-point proicKol) is a protocol tliat allows 
users to dialup a connection to access Llie Iniemeu This 
connection is basically a VPN. You’re using public 
lelepliune lines lu access the Internet, bui the access is 
insecure. Point-to-point tunneling proicK:ol (PPTl^) is a 
protocol developed by several companies but usually 
a.ssc:>c:iatetl with Mitvn)sofi. Micio.soft added it into every 
OS release since Windows 9^. PPTP was built on PPl' 
technology to create a ^'tunnel" allowing secure passage of 
information, PPP is the parent technology of PFI'P, and 
PPTP couldn’t exist wiLhoul PPP, PPTP sends data in 
encapsulated PPP packets, w^hich are tlien encapsulated 
w'irhtn fP packers, Rncapsulation allows you to send 
different protocols over IR That means you can send 
more than just IP packets over the VPN, It’s like wrapping 
pre,sents. You normally use different kinds of wrapping 
paper for different occasions, Christmas paper, birthday 
paper, etc, FPIT can only deliver IP packets over the 
Internet, which would l>e like demanding a present l>e 
wrapped in Christmas paper to be delivered. But if it’s 
really a birthday present, PPTP allows you to wrap ilie 
pre,sent in birthday paper, then wrap it in Christmas jxiper 


for delivery. After tlie packet is delivered, tlie packet 
header knows that it is really a birthday present and takes 
off the Christinas wrapping paper at its final destination, 
'I’hat is how you can send IPX or NediEUl packcLs over 
IP with PPTP. The trick of PFIT being able to send other 
packets over IP !ie.s in the fact lliai it mn.s at the OSl 
(open systems interconnection) layer 2, or link layer, 
ld*TP relies on PPP for its authentication and encryption 
rnetluKls, PPTP can be used to create a 'tunnel between 
tw^o locations using TCP port 1723. Once the TCP 
connection is established, both control messages and data 
(lackeis are ,sent from one endpoint to the othei, I'hese 
control messages do everything from initialising the VPN, 
to keeping it alive, and closing the VPN session. Contrtjl 
inc.ssagc,s also serve other maintenance functions for the 
VPN, The w^eaknesses of arc Ifiai it tines not 

provide strong enciyption for [jroiectiiig clata nor doe.s it 
support any token-based methods of audienric,atiiig users. 

L2TP (layer 2 tunneling protoi.'ol) c'oml^iines the l>esr 
feamres of PP1P and L2F from Cisco Systems into one 
proUK'ol. The Internet Hngineering Ta.sk Force flLTF) 
standardized L2n* for tunneling PPP across a public 
nerw'ork. ^Ilie main two components of L2TP are the 
Access Controller (LAO and the Nework Server (INS). 
L2TP is similar to PPTJ^ and runs over the OSl layer 2 so 
it can also route other protocols through TP packcas. Data 
is fonvardecl from the l^C, which can be your own 
computer or your ISPs, to the 1,NS. If you re inside a 
private network, L2TP may Ixr fine l^y iLseif. Because 
LZVP can't prev^ent packets from lieing changed, stolen, 
or faked, il is u.sually coml>inetl with IPSec when used 
across the Internet, 

IPSec is the most secure w^ay to connect to a \TN 
network. There are two components to IFSec: the 
authenticaiion header (AH) and the Encap.subi(ing 
Security Payload (FSP), 'Ihe All creates a special hashing 
algorithm and a .specafic key knowm only to the source 
and destination, which Is used to clicck for packet 
integrity, A security association is setup between tlie 
devices and the AH stores the output of the Special 
computatiem. Then tlie receiving device does ihe same 
computations, it checks the AI I to make sure the 
eonipLitations are the .same. Thi.s verifies that the packet 
has not been altered IVoui its tiriginal state. It is a 
checksum type of authentication, Tlie AH provides 
auiheniication but not privacy; the ESP doe.s that by 
encry^pting the datii. The ESP encryption algorithm is a 
key knowm only to the source and destination so no one 
in-betw^een can decrypt the transmitted data. 

TPScc can run in two differenl mtxles. These nKxies relate 
to how IPSec is set up. If two routers are creaiing a VPN 
connection, it uses tunnel tncxle; but if the VPN is host to host, 
it uses iransixirt mode. In transport mode, only the data portion 
of the packet is encrypted. To obtain tnaxiiiium security, one 
should use tunneling mode where the entire IP packet is 
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encrypt<sd and audienticated. The only downfall of IPSet is that 
it runs on OSI layer 3 and only supports IP packets. There is a 
way to uv'CTct>me tins however. Bundling L2TP with IPSec 
allows a VPN with maximum security and multiple prot(x:oLs. 
Because IPSec by itself has no way of Lunnelmg, it Ls iiomially 
only used with 12TP. L2TP creates the ttinne! and IPSec allows 
it to Ix! secure. Tliis is the most secure w^ay to create a private 
network and is being adopted as the best sutndard. KFC .3193 
describes the standard for bundling L2TP ^ lP8ec. 
(http://www.faqs org/rfcs/rfc3193*html) 

os 10.3 & VPNS 

OS 10.3 Panther has built in VPN client suppt>rt through the 
Internet Connect application (see figure 1). It currently allows 
for two tiiffereni kinds of VTN connections: FPTP or L2TP over 
IPScc in transport mcxle. 


Voyr computer needs to be set up to make VPN conit«alOO$. 

To contifliit with Htkijp. choose which kind of VPM you^d hke to conhgufe, 
and then click Cnntkvue- Check wjfih four network jdfninkrriiof it you ere 
unsure which to choote. 

0 LZTP ovej IPSec 
OW'TP 

( Cancel (^ Continue 3 


Figure 1 * VPN Connections 

Apple doesn’t allow for plain IPSec connections t>ecause, 
“Pure IPSec only provides user audienticaiion or configuration 
of the client machine through protocols which are eiilier 
proprietary or defined by the long-expired IETF drafts, which 
are not .standards. Using PPP/LZTP over IPSec is the only 
"standard" way of doing remote access with user authentication 
and IP address assignment over IPScc at this time.’' 
(hnp://docsjnfojpple.com/artide.html?aftnum= 108088) what Apple 
means by "Pure IPSec'' is using fPSec without the internal 
encapsulation. The built-in functionality t>f tlie VPN client for 
OS X is very limited, but there are good applications for 
ex(>anding that functionality. VPN Tracker 

(http://wvM.appiexom/downloads/macosx/networking^security/vpntrack^^^ 
html) is an excelieni application for customizing your VPN 
connection. WN I'racker is one of many products developed 
by equinux for VPNs. VPN 'I'racker allows you to customize 
every option of the connection (see figure 2). It also has buili 
in support for a large numlx^r of VPNs from major vendors. If 
you choose the option for that specific VPN server, it will 
autonixitically set all the netxrssary options for you. 



0 0 O CortrvetTton Type: Umitted 2 

Conneoioji Ty|!«: Untitiedl 2 

- * Phase I General I Vhasg 1 i Phase 2 ^ 

Encryption Algoritfim: f^des 

Hash Algonthm: [ mdS f $ | 

OH Croup: ^ mpdpX024 [■ * } 

Lifetime: g [ hours Tj j 

^ Send certificate 

^ Send request for remote certificate 
Verify remote certificate 


aick the lock to prevent further changes. 

Restore Defaults Cancel ^ f OK ^ 


Figure 2. VPN Tracker 

Equinux also makes a VPN Tracker Server in c:ase you want 
to seaip a VPN connection to a specific computer on your 
network. If you decide to seiuj.) a software VPN and you are 
behind a NAT (Network Address Translation) router, you need 
to make sure it has VPN pass-througli enabled or the proper 
TCP/UDP ports are being fonvarded. 

Conclusion 

Selling up a VTN can be complicated; but with the proper 
hardware ^ software, die average Macintosh user can do it. With 
all the different prototx)ls, setup needs to lx tliought out before 
hand. If you choose a Iiardware router/VPN, research the 
manufaaurers products first to see which protocols diey work 
with. I've had no problem with my Linksys router, and I’ve setup 
other cc)mman brands that have worked as w'ell (D-^Link, 
Nelgear, etc.) 1 would suggest viewing eqtiinux's website at 
http://www.equinux.conn/us/prodijcts/vpntr3cker/interoperabiliiyhtml for a 
list of prfKliicLs ihat work widi VPN Tracker. If' you’re going to 
use Internet Connect, it is very compatible with a large range of 
products; but doesn’t offer near as much castomizaiion as VTN 
Tracker. I strongly suggest downloading and trying out 
equinux's VPN Tracker to keep those private networks secore! 
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MAC IN THE SHELL * by Edward Marczak 


The She ll: What? 

It’s What You’re Using In The Terminal 


What in the What? 

Last mondi, we talked about “tlie 
terminal.” However, tlie focus was 
primarily on Terininal.app itself, and much 
less about wlial t)ne actually ckxis witli it. 
Basically, Temiinalapp is our interface to 
the shell But what is a shell? In short, it’s 
tile user interface into Unix* It accepts 
input, processes said input, and is 
responsible for output. Much like a 
GUT*, - just with much less emphasis on the 
‘Graphicar component. Aside: any old 
NetWare users will tell you of componenLs 
with die acronym ‘lUr in them. You 
gues.sed it: dial’s how they named their 
texaial user interface’ comfXinenLs, made 
to be mil at the (text) console. 

So a shell is really a layer of 
alistraction lietween die user and the 
core of the OS. Between the time of 
punch cards and graphical interfaces, 
text ruled die computing landscape. 
The first major shell available for Unix 
was the Bourne shell ("sh”), named for 
its creator Steven Bourne, An alternate 
shell, called the C shell ("eshO showed 
up, which took much of its syntax and 
semantics from the C programining 
language. In the Unix spirit of complete 
flexibility, the shell was designed to be 
independent from the OS. Compare 
that to certain OSes today that won’t 
even let you remove a well browser 
without coming to a complete halt (or 
so were told...). 

So, what Tm getting at liere is that 
we’re going to have a lot less pictures 


tliis month. Learning to use the shell is a lot like playing an 
old Tnfocom game: you stumble around a bit, you get told 
that you’re talking nonsense, but you ultimately miip 
everything out and learn your way around. Even if you 
iiaverVi visited every nook and cranny. 

So much time, so little to do! 

We’re only going to cover shell basics this month, which 
must be understood to be built upon. You liave all the time with 
thus column as you need. Tlie focus here will be to compare 
Finder actions with their aimmand line equivalent. Next month, 
thougli, we’re going to pile more on top of w'hat is learned this 
month, Two things to note for this column: a) The word 
Tolder’, primarily used in the Finder, and 'directory^’, primarily 
used in tiie shell refer to die same aincepi: a logical container 
that can hold files and other Folders. 1 use diese terms 
intemhangeably, b) 'Fhe tutorials here assume chat you have a 
'standard configuration’ for your Mac: volumes show up on die 
deskrop, you haven't altered your sheJl to smn you off in some 
cxltlbal! loc:adon, /Users is In die default location, etc. If youVe 
made tliase types of dianges, I can only guess that you know 
wliat you’re doing and can ctxnpeasace for it hem. Actually, if 
you made those Idnds of clianges, you’re probably not even 
reading tliis. 

As of OS 10,3t Apple has made Ixish llie default shell, tiasti 
was aeated for the GNU project, and showed up in early 1988. 
n is a variant to the original 'sh’, with a few additions. In the 
grand tradition o( computer wit, it’s only natural that there’s 
some humor l>eliind die name: l:>ash stands for die "’Bourne 
Again SHelJ”, just for reference, as of 10.3.7 and 10-3.8, the bash 
version \s 2,05b .0(1), 

From here on out. I'm simply going to refer to Ixasli as “die” 
shell. It certainly has become very popular, and again, is now 
die default for Pandier (and, I hope, Tiger), esh, zsh, ksh and 
odier shells all have llieir purpose, and dieir Ians. However, I’m 
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W ; hile there are many elements that contribute to the Zen of Unix, 
understanding the shell is, if not the pinnacle of this list, pretty close to it. 
To truly grasp not only the basics of shell use and programming, but also 
what is going on when you press ‘return’, will increase your skills considerably. This 
month’s column will introduce us to ‘the’ shell, and demonstrate some substantia] uses. 


really happy that bash is now the default. Under earlier releases 
of OS X, one of the fust things I did was to change my shell away 
from tcsh (Tenex C SHell, Apple's earlier default), and 
iimnediately change to lyasli. Again, tliat’s just one of the great 
tilings alxjur Unix: tlexibility. As a imilti-iiser OS, each user on 
the system can chcxjse the shell that they prefer, and have iliai 
presented when tliey login. 

Where it’s at 

bash is primatlly intended for two tilings: interactive use, 
and hiU-blown programming (or, "scripting”). However, moving 
from interactive use to programming is evolutionary. Before you 
know it, youll lx* writing scripts tliat automate your system iind 
make your (or your customers’) workflow easier. We’re going to 
start with interactive commands: typing one command at a Lime, 
and getting output appropriate, Some of this should 
familiar if you followed along last month. However, this time, 1 
give a little more detail and explain the 
underlying exmeepLs in a more cliiect context. 

Let's get to it, making one note first: as 
you follow along in the examples below, all 
capitalization and spacing is irni^>itant. It 
makes a difference. So, if something isn't 
working for you, or you rec^eive an error 
message where 1 say stimelhing will work, 
just double-check what youVe typed. 

Now, what could be more l^asic tlian 
opening a Finder window to peek at Llie 
contents of some directory? If you double¬ 
click on your hard drive icon in the hinder (or 
die ecjuivalent of that action, like using the 
sidet>ar, etc.}, you’ll basically be looking at the 
root of your flle-systeni. Unlike a real life tree, 
the Yoot' of a hard drive refers to the top level: 
every tiling flows down from tlicre. Launch 


I’emiinaLapp. (You have it in your dock by now, don’t you?) 
And there sits the cui^sor, blinking away. Well, just like double¬ 
clicking die liard drive icon, Tennmal.app starts you out in a 
directory, it just doesn’t display it until you ask it to. You start 
out in your home dirertory. How do you know that? Use the 
“pwd” command - diis displays your “prusenl working 
diiectory.” In my case, typing “pwd” reveals VUsers/irarcziik”, 
lliis shows my path from die root of the file-system. This Ls the 
same as saying, "double-click your system drive, then double¬ 
click on ‘Users', and once more on the folder named 'manrzak’”. 
Now that we know where we are, let’s see what’s dieie, and 
comprare that with whar we see in die Finder. 

Switch to die Finder and A|:)ple-Sliift-H to liriiig up your home 
diimoiy. You may also want to ptit diat window into column 
view, sorted by name. Back in the terminal, type is -I", Tliis 
simply LeUs tiie Ixish siiell to ‘list' tlie contents of tlx^ directory you’re 
in. Tlie -1’ switch gives us a tong view; in odier words, it giv^ 
some more inanimation. This should lx? familiar giound if ytxi 


drwxrwx- - - 

25 

marezak 

marezak 

830 

12 

Jan 

12:51 

Applications 

drwxrwx--- 


marezak 

marezak 

1598 

8 

Feb 

■01:01 

Applications Ait 

drwrwx- - - 

22 

marezak 

marezak 

748 

12 

Jan 

09:25 

Audio Appfi 

6 rw x rwx-- - 

h 

marezak 

marezak 

.136 

5 

Nov 

07:48 

Crapplications 

drstfx - 

52 

marezak 

marezak 

1768 

8 

Feb 

17:05 

Desktop 

drwx- 

56 

marezak 

marezak 

1904 

S 

Feb 

00:41 

Documenta 

-rw-t'-r-- 

1 

marezak 

marezak 

0 

14 

Oct 

17:54 

lO.S^S 

drwxrwx--- 

3 

marezak 

marezak 

102 

1 

Feb 

15:52 

ISO 

drwx-- 

44 

marezak 

marezak 

1496 

7 

Feb 

08:56 

Library 

- rw-t- - r- - 

1 

marezak 

marezak 

0 

14 

Oct 

17:54 

MSDOS.SYS 

drwx 

23 

marezak 

marezak 

7S2 

3 

Feb 

10:20 

Movies 

drwx . 

58 

marezak 

marezak 

1972 

T 

Feb 

07:17 

Music 

d rwx -- 

29 

marezak 

marezak 

986 

30 

Dec 

07:17 

Pictures 

drwxr xr x 

4 

marezak 

marezak 

136 

6 

Oct 

08:46 

Public 

drwxt:-xi:-x 

6 

marezak 

marezak 

204 

22 

Dec 

17:46 

Sites 

-rw-r-~r - - 

1 

marezak 

marezak 

618 

30 

Dee 

09:44 

StCDS.zip 

drwxr-xr-x 

5 

marezak 

marezak 

170 

26 

Oct 

16:39 

ZDE 

-rw-r'-r-- 

1 

marezak 

marezak 

1044904 

27 

Jan 

11:56 

Enz Server.nfo 

drwxrwx- - - 

9 

marezak 

marezak 

306 

26 

Dee 

00:04 

bln 

d rwx r - X — 

5 

marezak 

marezak 

170 

31 

Dec 

2003 

bin2 

drwxr-X - - 

39 

marezak 

marezak 

1326 

9 

Jul 

2004 

bin3 

- rw -r- -r - - 

1 

marezak 

marezak 

1464 

5 

Feb 

23:39 

ca.ert 

-rw-r-' — 

1 

marezak 

marezak 

5715 

25 

Oet 

08:18 

edtarm* term 
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tbllowed ajong last month. Yai should get a listing like ihis: 

This file nanies you see in this listing should crorrespond with 
wlial yoLfre seeing in die oix*n Finder window. 1s' can do more 
than this, diougli* Just as you may sort the Finder window ]yy 
diherenr criteria^ Is can do the .same. Tf you want to order the 
listing by time (or, TVate Modified”), you can add the 'f switcli, 
like diis: is -It”, 'Hiis places the most recent ckites at the top and 
goes l.’fack in rime from there. If you want to reverse th is order, 
you can, widi die Y (reverse sort) switch. Try it: “Ls -Itr", You 
should now see the contents of your home directory, sorted from 
oldest to newest, 

TF you command-click or right-click in a Finder window, 
yoifre presented widi the option of iruiking a '"New Folder”, 
bash will do tills widi the ‘mkdir’ command. Wliile still in your 
fiorne dircd.ory', tyjx^ “mkdir MacTechTesf and press Enter, Tf 
you switcli back to your Finder window, you’ll find a new folder 
there called “MacTechTesf*. W you type “Is in die terminal, 
youII also see your directory lisfcxi. Now, go lyat:k to ilie Finder 
window^ and move your “MacTeciiTest" folder to tiie trash. Run 
another “Is -1” in the terminal Yoifll notice that the file is gone! 

For die nexi comparison, please open up TextEdit (which, 
by die way, can lx: done widiout ever leaving Tenninal.app l>y 
tyjiing, ‘'open /ApplicationsA’extEdit.app”). Create a quick test 
file, and save ii in your home directory. Call it 
“ShellExample.txfl Once you save it, quit TextEdit, and hof> 
back over to Tenminal, Onc'e again, you 11 see tills file with “Is 
-I”. But, you kjiow, we should liave a second copy of tills file 
- right in the .same dimetory. In the Finder, you’d either drag- 
and-drop widi die option key down, or .selea the file and Apple- 
D (File->Duplicate), We can make a copy of this file iji several 
ways, bur we’ll,start out doing .so via the ‘cp’ command. As you 
probably guessed, stands for “copy”. Type “cp 

ShellExample.txt Mac'i’ecIiExampIe.txt”, lliis takes the first file 
(SheEExample.txr) and copies it, giving it tlie name of the second 
file (MacTcoliExample.ixi). Go clicx:k your Finder window to 
see botli copies. One difference lietween die I'inder and die 
default actions of rlie CLl to note liere: T you copy a file, and you 
liave a file wilii die same name in the destination, will 
liappily mow riglit over the destination file, replacing it with die 
File you’re asldng it to copy. (Compare that with the Finder which 
will prompt you before doing anvil ling like that. If you like die 
prompt, you can use die 'T (intenictive) switch. If you tr^^ diat 
again widi the “i” switch - “cp -i ShellExample.txT 
MacTcchFxample.txt” — you1l get asked, “overwrite 
MacTeehExample.txL^ (y/n [n])”. You need to tyfx: “y” luid press 
enter for the copy to take place, Any odier response cancels the 
copy operation, ancl you are notified with, “not overxv^rilten”. 

Tllinking alxiut it, we don’t really need Ixilli ctjpies; let's 
dump one of them. Type “rm ShellExample.txt". Yep, “ml” 
stands for “remove’'. Here's an example of a command that acts 
differently from the Finder. When you delete something in the 
Finder, you move it to the Hash, where it sits until you decide to 
“empty trash”. Conversely, “nn” nukes the file on the spot. No 
ability to retrieve from the trash here. Once you hit that Enter 
key, it’s gone, fk), always Ik* a little aireful wiiJi the “rm” 
command. If you want die added comfort of a confmmtion 


prompt, you am use the i" switch liere, too. “nn -i filename” 
will ask "remove filename?” Only a reply of “y" on your pari 
will remove die file, Any otlier lesponse cancels die action. 

Create a test folder again: “mkdir ShellFxample”. Now we 
c'an move our file into the folder we just created. In tlie spirit 
of Unix economy, die command for move is "mv”. Just like die 
cp (copy) comm^md, you follow the mv comm;iiid the names 
of two files: where it is, and where you want it to go. In diLs 
case, we’ll move our file widi “mv MacTechExample.txt 
ShellExample/”. We c'an diange our ament directory liy using 
the ‘change directory' command: “cxi”. Type “c;d SheUExample” 
and piess Enter. Now, list die aintenls of diis directory, and 
you’lJ see the file that we moved in here. Note thit your pmmp! 
has changed to keep you abreast of your airrent direiiory. Your 
piomfit should end with soinething like -/ShellExample 
yseniame$’, wliere risermmie’ is your user name. 

Why did I caE that file ’MacTechExample.txr? We should 
name it 'ShellFxample.ixi', like the directory it’s silting in. You 
rename files with the 'mv’ command. 'Iliiiik about it: renaming 
is reaEy just moving the file witliin the same directory and 
dianging the destination name. TyfK “mv MacTechExample.txt 
ShellExaiiiple.txt”. List die duectory again ^md note the change. 

Bring me home 

We'll wiap tills up with by btiilding on the commands jiist 
covenrd. First, to gel buck lo your home directoiy^ type “ed” 
wiLli nc> aigumenls. Press cuter, and you’re liack home. 
Again, note that your prompt refiects this change, by just 
showing the tilde symbol Wliidi brings me to talk about 
special charactei-s. 

So far, Fve shown you tilings that you c'^in do botli in die 
Findei; and via t!ie command line. Well, what gaxi is that? 
You’re here to leain the power of the aimmand line, righP 
GcxkI. Let’s go! 

One of flash’s jobs is to liiaik apart your input into lolcens, 
and act in some way on tlio.se tokens. Sometimes, you type 
sometliing dial is destined for Ixisli iLseT. More often, you're 
really running a command that isn’t built-in to liash, so bash lias 
to fire up that command as a prex'ess, and pass it any aigumenLs 
that youVe supplied. Aiguments are eidier literal - you’ve given 
a name exaaly as it exists on the file-system, or, you give bash 
an approxim:ition or, pattern, to match and have iTash figure out 
the rest. For example, youVe now learned that the tilde 
diaracter Ls special to bash, and it means “niy home directory." 
However, under the covers, bash expands this to its real value. 
My home is ai A l.sers/mart;xiik. When I type "cxl to go liome, 
i>asli calls but dianges the parameter from to 

VUsers/niarczak’, without you liaving to do anything. Tliere are 
more chaiucteus that liave special meaning to die bash shell. 

Of all the characters dial Ixish reeognizes as special, die 
string midcarzi chaiaaer is probably the raost-oft used. Since 
it’s used elsewhere, you're mast likely fiimiliar widi the asterisk 
(“*”) tieing used in this opadty. "Is” is a great ttx)l to illustrate 
how tlii.s works. Earlier, we simply asked 'Is' to display all 
contents in our cuirent directory. However, “Is” will List specific 
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items when asked tt) do m>. For instance, no matter where yon 
are in the file-system, you can type is -I to see tlie contents 
of your home directory. Remember again, diat bash turns the 
tilde into ^'AJsens/asemafne'' betwe is' ever sees the pamnieter. 
lliafs a hugely im|x>rlant concept. “Ls'' iLscif does n<H Ititve to 
figure out wbit die tilde means - it never sees it. 

Make sure you’re in your home directory <“cd” Icnter].) and 
type “Is Public". You'll see something like ihis: 

drwxr^xr x 4 mirc/Hk marcKak B6 6 Oct OB:46 Public 

Tlie ”d" switch tells Is dial if die aigumeni is a directory, that you 
want to see die diiectory name, and not ils contenLs. Widioui 
die d' switch, diis is w^hat liappens \\idi "Is -1 Public"* 

drwx-wx-wx 3 marezak marezak 102 6 Oct OS:46 Drop Box 

Set^ We’re shown the contents of 'Public*. Ilowevet; diere aje 
siiuaiions that you dtin't know the exact name of the fde or 
directory. Thafs wliere die string wiklc^ard comt's in. Try thLs: 

-I P*”. You should get something similar to diis: 

drwx— 29 marezak marezak 986 30 Dec 07:17 Pictures 

drwxr xr'x 4 loarczak marezak 136 6 Oct 08:46 Public 

1 don't think you can do ti)al witi) die Finder. Want to see 
which “lApps"' you have installed 
in /Applications ? (See sidebar 
Figure L) 

Conveniently, the string 
wildcard can be used anywhere in 
the pattern, and it will match any 
number of characters. For 
example, I may need to find all of 
my Konfabulaior widgei 
directories. I’ll go to my 
-'/rkxuments direaory and type: 

(See sidelxar Figure 2.) 

Notice the pattern: wildcard 
up front, anti one in back. Tliis 
way, we find the word “Widgets" 
no matter where it appears. One 
last reminder about this: it’s the 
bash shell dial takes care of 
dealing with die wildcard. Tliis is 
called expansion. In the previous 
example, the bash digs through 
the nie-systcm, finds die matches, 
and then passes that to “Is**. When 
we typed “Is -kl Widgets", “Is” 
only saw diis: 


"Is -Id ‘Older Widgets* ‘Older Widgets December 29" 

"Widgets'" 

Wliile I parapiirased dial sligliily fi)r case of explanation, the 
point is that tfs tJie shell that deals with tiie si:>ccial characters, 
and die pnigrams and built-in aimnkincis never see tliat input. 

One great way to test shell expansion (also known as 
j^lahhittg), b widi the ‘echo* command. As you can imagine. 
*Lx:lio’ will echo its argumenLs to the console, If you type “echo 
Hello dieie.” and press [enter], echo will spii out “Hello there." 
ngliT back at you, and tlien hand you liack die pnxnpl. ‘echo* 
also respeas the patterns and special characters we’ve 
discussed. To see what T mean, try this: “echo 1 get thb: 

/[jEerB/marczakVPicturGe /Uaets/miirczak/Public 

NatuniUy, you'll have your u.ser name in plate of mine. IMs: 
“echo -/•ib*" gives me ilib: 

/Users/marezak/Library 

"llieie are more special diiiraaeis iluu die shell rcctigni/i^. Tf 
you*d like to see all files that tiegin with an e, q or v, w^e can use 
cbaracler-set tiiklcards (or, bracket wQdc^irds). lliis: “b -1 
/usr/bin/leqv]*" gives us dib (ctlitc-d for brevity, plea.se see 
sidebar Figure 3J 


J$^ls Id /Application^^ 
ydrvxrvxr-x 3 root 


Jdrwxrwxr-x 
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|drwxrwxr‘x 
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i* 
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/Applications/iCal.app 
/Applications/iChat.app 
/Applications/iDVD.app 
/Applications/iMovie.app 
/AppllcaLions/iPhoto.app 
/Applications/IStumbler.app 
/Applications/I Sync.app 
/Applications/iTe rm.a pp 
/Applications/iTunes.app 

-- m 


la 


Is ’Id •Widgets* 

IdrwxT-xr^x 5 marezak marezak 
|drwxr-xr-x 17 marezak marezak 
Bdrwxrwx— 30 marezak marezak 


170 29 Dec 01:02 Older Widgets 

578 10 Nov OS:54 Older Widgets December 29 

1020 30 Dee 07:07 Widgets 





liffji; 1 

pn 




’iT'xr-xr-x 

1 

root 

wheel 

85800 

26 

May 

2004 

-rwxr-xr-x 

1 

root 

wheel 

98260 

26 

May 

2004 

-rwxr-xr-x 

1 

root 

wheel 

89444 

26 

May 

2004 

-rwxr-xr-x 

1 

root 

wheel 

30716920 

21 

Jul 

2004 

-rwxrxr-x 

:i 

root 

wheel 

37921 

12 

Sep 

2003 

-rwxt-xr-x 

1 

root 

wheel 

292356 

26 

May 

2004 

rwxr xr-x 

1 

root 

wheel 

164756 

26 

Hay 

2004 

r-xrvxF'X 

1 

root 

wheel 

14044 

26 

May 

2004 

-r-xr-xr-x 

1 

root 

wheel 

35856 

26 

May 

2004 

*rwxr-xr‘x 

1 

root 

wheel 

61164 

26 

Hay 

2004 

-rwxr-xr-x 

1 

root 

wheel 

84784 

26 

Kay 

2004 

-r-xr-xr-x 

1 

root 

wheel 

14036 

26 

May 

2004 

-rwxr-xr-x 

1 

root 

wheel 

117424 

15 

Dec 

20:33 

r-srxrx 

1 

root 

wheel 

20072 

26 

May 

2004 

rwxr ' xr X 

1 

root 

wheel 

3266 

12 

Sep 

2003 

Irwxr-xr-x 

1 

root 

wheel 

3 

12 

May 

2004 

lrvxi:‘Kr‘X 

1 

toot 

wheel 

3 

12 

May 

2004 

-rwxr-xr-X 

1 

toot 

wheel 

967284 

26 

Hay 

2004 

ir¥xr-xr-x 

1 

root 

wheel 

3 

12 

May 

2004 

-r-xr-xr-x 

1 

root 

wheel 

15004 

26 

May 

2004 

’r’xrxr X 

1 

root 

wheel 

40564 

10 

Feb 

15:09 


Figure 3 


/usr/bin/eaytest 
/usr/bin/efax 
/usr/bln/ej^rep 
/ usr/bln/einacs 
/usi:/bin/enc2xs 
/ UEi:/bin/encode_key change 
/usr/bin/enaccipt 
/usr/bin/env 
/usr/bln/ercor 
/usr/bin/escputil 

/usr/bln/etagB 
/usr/bin/expand 
/nsr/bin/expect 
/usr/bin/quota 
/usr/bin/vera^strlng 
/ufir/bln/vi > vIpv 
/ usr/bln/view > vim 
/usr/bin/vlai 
/usr/bin/vimdif£ ‘> vim 
/usr/bin/vm_stat 

/usr/bin/vmiiiap 

‘ 
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As expec'tcxi, all of liic files start with e, q or v, and the asterisk 
wildcard imiches anytliing remaining, the brackets will also 
accept a range of charaaers. If you had a grotip of ftk^, named 
by date, ycHi could find all of tlie files in a direaory for the year 
2001'2004 widi die command ^Is -I 200[1-4J*''. r.>ont forget that 
you can group these any way yoifd like. To find dates dial 
match 1973-1975, 1985-1985 and 1993-1995, you could use this: 
“Is -1 1917-9113-51*". 

You can also tell bish that you want everything hut tenain 
patterns, lliis is die job ibr die 'not' operator, wliich is 
represented liy die exclamation {Xiint (“!"). If 1 want to find 
cvcrydiing in a dii'eaoxy diat starts widi but does not end in 
‘sh', Id type “Is -Id pllshf, and would see: 

-rv r-r— 1 marezak inarezak 21251 12 Jan 11:09 
printjobfail,zip 

,..even though this directory contains “printlist.sh" and 
’*ps('hed.sh'*. 

Similar to die square brackets, you can use curly braces u> 
match a list of values. The list is separated widi ainimas. For 
example, if you want to list all of the graphic files in a directory, 
you could use “Is -I *.{gif,jpg,bmp,swfl’\ Note, though, that you 
will receive a such file or directory" message from Is for 
anything in tlie list Lliai it couldn't find echo, naairally, will just 
echo die ex|>ansioii iiack at you, like this: “echo *Jsh,txi,xxxr 

fort.sh sbowdj3,£ili upsafari.sh l.txt mailcap.txt * .xxx 

Note the "*.xxx" I tanging on dte end diere, as die shell didn't 
find a match, it passes this to echo unaltered. 

Lasdy, we'll cover die ciuestion-mark wildcard. Tlie 'T 
character simply inauhes any one character in a laige 
directory, typing “Is ?at.Dct'’ could potentially give us: 

bat.txt cat.txt rat.txt 

Tliere arc* odier charaaers that trigger actions in bash, such 
as expaasion, input/output redirection, joli control, and more. 
While these characters are very helpful, lliey can also trip you 
up. Wlien IXLsh sees any of these chiiraaers in its input, it tries 
to aa on them the way intended unles^s you tell it otherwise. 
One character that is particularly Uoublesome for people is tile 
ampersand CSl'^X For now, just know diat this causes Ixisli to 
Rin your command in die background When diere's an 
ampersand on the line, bash runs your coitiinand and 
immediately has you kick the pmmt. Great for long mnning 
jolis that liave no interaction. 

But what if in the Finder you've named a Iblder “58lT, and 
you need to acxes.s k while in a terminal? Well, let's see. Open 
up your home directory in die Finder, and create a direaory 
named “5AtT'. In die terminal, ckinge to your home diretriory, 
and type “cd 5&7''. You'll get: 

[1] 2299 

bash: cd: 5: No such file or directory 

bash: 7: command not found 

ni t Exit 1 cd 5 


What's going on here? Since die amjiersand puts your 
cxniimand in die liackground, the first line tells you the job 
number diat bash assigned so you can track it later on. Since the 
charaaer has special nie^ining, liash lias (roughly ) tokenized 
the input into "cd 5 and “7". It runs "cd 5", and tells you “No 
such file or direaory". It tries to run a cximmand named "T, and 
reports that ifs nor found. Finally, we’re u>ld dial job numlier 1 
has finislied (exiled out of iLs subshell). 

How^ can you get die shell to treat special characlers as 
normaf plain-old charaaers? You need to quote them. One way 
to do this is to use the Ixickslash csc^ajie. Tliis tells bash to ignore 
ilie special attributes of die charaaer diat hiimediately follows it. 
Wlien you use tal>conipletion, you1l notice ihat fyash Irackslasii' 
escapes characters for you. Try typing “cd 5[iali]", and you’ll see 
tliat I xLsli cTimpletes widi “cd 5\^7/'’. It escapes die ampersand 
by placing a backslash in front of it. li will do thb with mast 
spedal characlers. Here's a list of tharaaers that have a S|iecial 
meaning for hash: 

* Wildcard 

7 Character wildcard 

[ ] Character-set wildcard 

f 1 String-expansion wildcard / Command hlock 

^ Home directory 

' Coiranand substitution (backtick) 

$ Variable 

fi Background job 

C ) Subshell 

\ Quote 

I Pipe 

> Redirect output 

< Redirect input 

/ Path separator 

j Logical NOT / History expansion 

: Command separator 

* Strong quote 

" Weak quote 

Space 

@ Positional parameter list (only when used in 

double quotes) 

This is not an all-indufiivc list, but it contaias die characters that 
will cause you prolilems if you want them to behave without 
their special powers. 

One interesting way to deal widi dlls only works (airrendy) 
witii Tenninalapp. You am drag and drop files and IViltlers from 
a Finder window onto your Terminal.app window. 
Terminal app will substitute the full paUniame of die object 
dix>pped, profx^rly esai|x*d and quoted, Fretty ccx)l. 

The other ways to quote are to use the t|uc>lc 
cliaracters...who’d-a-ihiink, eh? Tlic single quote is a hard 
cftmie. From the ba,sh man jiage: “Enclosing characters in 
single quotes preserves die literal value of atch ckiraaer within 
the quotes. A single cfuate may not ociotr lx.iween single 
quotes, even when paxxxlcxl by a Iracksiash.'' BasicaUy, we 
could replace our exiimple alxjve by typing “cd ‘56^7’". 

IXHjblenquotes are Agjdn, from the Irasii man 

page: “Enckising t'haratiers in doul>lc quote's preserves the 
literal value of ait ciiaraaers widiin die quotes, with the 
exception of $, ', and \. Ihe ciiaraaers $ and ' lebiin dieir 
speckil meaning within double tjuoies. The Ixickshsh retaiiis its 
special meaning only when followed by one of the following 
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characters: \ \, or <newline>. A double c|uote may 

cjuoied within double quote?i l:>y pnett^ding it with a back- 
slasli. The .special parameters * and @ have .special meaning 
when in double t^ur>tes.'’ Til be going deeper into tills concept 
next month. 

Getting Help 

This material lias been a Ixisic * hut importani tbundation. If 
you understand these concepts, you’re rciitly for more. Plenty 
more is coming next in next montli’s coliunn. But what alxiiit 
tlie time between now and tJien? You want to experiment, rigliL^ 
You warn to see what else can lx done (rn ihe command line. 

List moniii's t'olunin talked a little bit aix)ut tab completion. 
Ychi type a few letteix, hit tab, and tlie slieU tries to coinplae 
yt>ur words with a match. Unlike ihe cnimmy tali a>mpletion in 
Windows, if liiere are niultiple matches, irash Ixeps at you to let 
you know. Pressing lab again will display tlie inaiehcs. What 
we didn’t cover last nionili Is iliai this works with commands, 
coo. Try tills: type “Is** and press tab twice. You1l .see all of tlie 
commands (in your path) dial liegin witli “Is"’, Here’s whai T get: 
"Is Isbom Isof Isvfs", OK.,. 1s’... check, 

dslx)m’..,.good..,'Lsof,. .know it,./Isvf,,,what is that?’ 

Tliere are a few^ ways to tind out what dial Is, One way Is 
the ‘whatis’ command. Try typing "wiiatis Isvfs", and you’ll get 
tills an.swer: 

IsvfsCX) ' list ktiowu virtual file systems 

Oh, OK! How does that comixire lo something we know? Press 
’q’ to gcL (Hit of the listing for Isvfs and type “whatis rm”, 1 get: 

rm(J), uuliuktl) - remove dI rectory entries 

Well, yes, that sums up the nn command nicely. What does 
whads liave to say for itself? 

1 $ whatis wlmtla 

apropos(1), wbat:is{l) - search the whatlE database 

getNAME(S) - get NAME sections from manual 

source for whatls/apropos data base 
inakewhatis(8) - create whatis database 

Wow, tint’s a little more infbnmtion tlian we got with tlie other 
commands. You’ll notice that there me two entries dial claim to 
'searc'h the whatis database’. The 'apropos’ command is lyasic'^illy 
die same as whuitls, except the piimmcter that you give ir is a 
pattern (spedfically, it’s a regular expiession, wliicfi, yes, will lie 
dealt with in a future column). Unless you’re careful, apropos 
am give you teas of output Hicm’s two ways of getting help 
that am much more aseful. 

Ihe b;ish shell itself has built in help using die 1ielp’ 
command. Try it. Hiis help Is great, hut only covers l>ash, and 
not die many, many, many cxjmniands tliat exist on the system 
outside of Ixish’s liuilGias, If you want to know more alxiui Lsvfs 
tlian simply that it will “list known virtual file sy-stems”, you’d use 
'man’, ’man’ let’s you access the Unix dcxuinentaikin stored in 
the Inan’oal pages database. You teU 'man' whtdi ctimmand 
ytHi’d like to read up on: “man Isvfs" gives much lietter detail 
about diis command: 


LSVfS(l) BSD General Corwuands Manual LSVFS(l) 

NAME 

isvfs ‘ list known virtual file syateros 
SYNOPSIS 

isvfs [vfsnanie ,,*] 

DESCRIPTION 

The Isvfs command lists information about the currently 
loaded virtual filesystem modules. When vfsnanie arguments 
are given, Isvfs lists information about the specified VFS 
modules. Otherwise, Isvfs lists all currently loaded 
modules. The information is as follows: 

Filesystem the name of the filesystem, as would be uaed in 
the type parameter to mount (2) and the -t 
option to mount (0) 

Refs the nuaiber of references to this VFS: i,e,, the 

number of currently mounted filesystems of this 
type 

Flags flag bits 

SEE ALSO 

mount (2), mount(8) 

HISTORY 

The cowmand from which this was derived from, as well as 
this manual* originally appeared in t'reeESD 2.0. 

BSD January 4, 2003 BSD 

This is a ttic’e, short exiimplc of a typioil man page. Many oUicr 
mail page-s c:an get fairly lengthy, just as IVc inirtxluced you to 
the ’Is’ coinimind and some of it’s switches tliat alter its output, 
please re^id the man page T'man Is”) and understand the depth 
of tills seemingly simple command! 

Man fjages exist for your reference and convenience. 1'ake 
advantage of them! As fonn of homework for next time, read 
tile man page tor ‘ditto’. It’s an inifxirtant Mac replacement for 
the ’cp’ ainimand. 

In a month, then... 

Like anytliing, tJie aimmand line takes a little pracUte. This 
month’s raiding should ease you into i],sage, and ]Doint you 
towards ways to learn a bit on your own. Until next time, 
tliougli, here’s one more thing to try: without typing anything, 
press tab r^lce and answer 'y’,.,ju,si kxik at all of the commands 
ill tlK^re to lairn ateut! 

[i^jj 
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DevDepot has it all! 


DevDepot sells the tools, toys and technology to put more muscle into your Mac, Visit our 
online store today for special offers and great new products, www.devdepot.com 


Television is about to get a whole lot more interesting.^ 


EyeTV 200 


The future of Television 



Watch TV on your Mac! 


Pause live tv! Record, edit 
and archive! -- 






Watch TV on your Mac 

EyeTV features a 124-channel cable-ready analog tuner and DVD quality 
MPEG-2 video encoder. 


NOW ONLY 

$ 324 ” 



go 

digital 


Convert your analog 
video tapes to 
digital in realtime, 
then burn them 
to DVD! * 

V.____ 


NEW! 



Record TV on your Mac and Archive to Disk 

Collect and organize your favorite shows to watch whenever you want, 
then update video content to DVD.* (Toast 6 Titanium required). 

Don’t miss a thing 

Use EyeTV's Electronic Program Guide to find exactly what you are 
looking for, and program EyeTV to record it. Program EyeTV from 
anywhere via the Internet. 

_ _ Features and Benefits 

I • Record TV otn Your Mac • MPEG-2 Video Encoding 

i • Edit Out Unwanted Content • Digitize Analog Video 

• Archive Recorded TV To DVD* • The Speed And Power Of Firewire 


Mew Export 
Furictionality 


EyeTV now lets you 
export to iMovie* 
iDVD®andDVD 
Studio Pro®, making 
it easier to create 
professional quality 
recordings. 






























More Great Products! 


SYNCBOX 


Buy Today and Save! 


Transfer data from your USB devices with 
the touch of a button. 

* Never run out of memory space again 


- No computer required, 100% portable 

- Sleek and compact design 

• Easy to use, one button operation 

' Complies with USB 1.1 specifications 

- Supports both USB 1.1 and USB 2.0 

• Uses 3 AAA alkaline batteries (not included) 



EASILY GET DATA FROM: 

• Storage Devices • MP3 Players 

- Digital Cameras • Card Readers 

• Flash Drives • AND MORE! 
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iTri pmini 

The iTrip mini was 
designed exclusively 
for the iPod mini. 


FM Transmitter 


Listen in your car! 

iTrip 


NO BATTERIES NEEDED! 

The iTrip mini only needs a tiny bit 
of power that it gets directly from 
your iPod mini. 


iMic 


USB Audio Interface 


n 




ONLY 

$3999 


f 




Its form 
matches all 
the curves 
of the iPod 
mini, and 
sounds even 
sweeter! 




The iMic is a must-have device for people 
who are serious about high quality audio. 

Connect virtually any sound device to 

your iBook, PowerBook, PowerMac or other 
Mac or PC with a USB port. 


IMic SUPPORTS: 

• Line Level 
Microphones 

■ Mic Level 
Microphones 

• Multimedia 
Devices 

• Headsets 

• Communications 
Devices 
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a Griffin Technology 
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A GenZte tntruductian ta the Python 

Prayramminy Lanyuaye 


By Christopher Roach 


Introduction 

I know what yoyVt' lliinkinir. "With all of the languages 
oui there why would 1 ever want to learn another one?" 
Well, if yonVe never used hython, and you've never had any 
ilesire to, then Tm sure this veiy suuenient can lie found 
rolling around in your noggin at this ver>" moment. But 
wait—^fiokl on \i\si a minutt^here are several reasons for 
learning Pytlusii, For instance, in the essay "The Python 
Paradox" Paul Graham states one of the most important 
reasons for learning Python. In it, he slates simply that 
“^^d^yihon programmers are smam" 

Well Pm not sure alKRit you, hut for me, the sheer fact 
that Paul Graham considers Python programmers to Iki of a 
higher intellectual caste is reason enough to learn the 
language, (In case you couldn’t tell. I'm a htg fan of Paul 
(Triliam’s essays and his insights into tlie hacker community,) 

Nevertheless, if you haveiVt found yourself totally ' 
convinced hy l>r. (jriham s imisings that good hackers prefer 
IMlicin, you may want to read on ju,si a l>ii further. The test 
of this adk promises to go over .several of the rea.sons why 
you would want to add it) your programming ux>II>t>x. 

Well Stan with [i shoii description of the Pytlton 
fangyage, anti what advantages it holds lor its users. Then, 
tn the latter half of the article, well lake a look at .several 
code editors and IDKs anti even one slanti alone KAI) tool, 
all of which will surely help make your uansiiion from 
relative newhie to Python |it>wer-user an easy one. 


liefore we gel started, how^ever, if you already consider 
yourself to be a fairly erudite Python developer, don’t turn 
away from this aiticle just yet. As 1 mentioned in the 
previous paragraph, well be reviewing c|uite a few 
tlevelopment ttK>ls that could easily help t>ut even the mf>st 
experienced Python developer So, you may just want to 
skip the next .section (since it mainly just .synopsizes Python 
for the newbie) and proceed onto the rest of the article 
where you'll hupehiily find some nice toys to play wirli. 

However, if you have no previous Pyihtm experience 
anil you find yourself interested in learning witat all the hyjx^ 
surrounding Python is about, go ahead and read on—the 
next .section is just for you. 

Why Python? 

Lets start with a i»<XKl oveiview of Python. I’ytfion is an 

interpreted, dynamic, object-oriented programming 
language. Sounds great right? Ihit what exactly do all those 
terms mean to me? Well, lets look at the aliribules 
mentioned aliove and discu.ss the Ixaietlts each [>rovkles, 
lansi, Pyihtjn is an interpreted language. Lhilike many 
traditional programming languages in wide use imtay-—such 
as C, C++, and Java—Python is noi compiled. Ibis has many 
benefits U) a programmer. To .start with, it means ihal 
programs can he written and executed instanily wiihoui a 
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cosily compile step. This cliLs down on llie edit-lesl-dehu^ 
cycle by allowing us co inimediaiely see the results 
changes to ryiir cotie. It also means tl^at we can write veiy 
small j>r()grains inieiuclively (i.e., each line of code is 
executed as we type it lo give us immediaie feedback), Whai 
this means is that any small task that calls for a shot! 
throwaway program can be created on the Hy il love tliis 
feature), Plus, learning new features of the language is a 
snap since all you have to do is open a command prompt 
and run the imerpreier to execuie, on the Fly, everything you 
type rather than gtiing through the arduoirs process of 
creating a file, adiling the code, compiling it, executing it, 
fixing it, etc. 

Second, Python is a dynamically ivfied language. A 
dynamically typed language is one that does not need to 
know the data type of a variable at compile time, but rather 
it can deierinine the data type during ilie runiime of live 
application through the context in which it is used, I'hus, 
when using Python, the time consuming practice of declaring 
all variables is avoided. If you need a variable to hoki a 
string, simply create a variable and assign a siring la it. 
There’s m> need to tel! the cbiiipilerTvharW^^ data type of 
your variable is, il can figure it out on its own. This lead.s to 
a much faster development cycle. 

Kinally, Pythtjn is an ohjecrorienied language. Now, 
since this article assumes that the reader has at least a small 
knowledge of programming f und hasn’t been living under a 
rcK'k in the recent exunputing past), HI spare you the details 
of die benefits found in using a language possessing object- 
oriented capability. HI just say c|uk'kly that, unlike other 
languages, such as Per! and C++, Python w^as developed 
from the ground up with the object-oriented paradigm in 
mind. This means that creating a hilly object-oriented 
program in Python i,s much more natural than it is in other 
pr<>tediirabinrned-t>hject-orterited languages. 

Well, that’s a nice de.scription, bin what else can Python 
dr> for me? Glad you asked. A few of “my'' favorite reasons 
for using Python are readability, ponability, and n large 
select ion tjf libraries and active devek>pers. Let’s take a look 
ai w'liat each can do for you. 

The first advantage I’ve named could seem to lie either 
a curse or a godsentl at firsk but mo.sr users of Python have 
grown to think of it as the latter once they got tised to it. 
Python has a rather C|uirky w ay of designating blocks of ctide 
tliat will prol>ably drive you nuts at first if you are a C/C++ 
or Java programmer by trade. It designates code hkxks 
without the use <j 1 braces or hegin-end statements. Instead, 
Python use,s indentation. This may seem like a very 
annoying trait at first, however, once yoiiVe had to work on 
a project with at least one otlier coder and tried to read their 
ill-formatletl cotie, you’ll lx.* praising this feature in no lime. 

Python’s use of indenuition-designaietl hkx'ks t)f ct>de is 
efficient, clean, and understandahle, plirs it makes sure that 


everyone on a programming project Follotvs an klentica! 
indeniaiitjn .scheme. It may take a few short programs, hut 
once you've gotten used to il. and you use a good etlitor like 
funncN that takes care ol the indeiiling for you, ytiii’ll find 
you actually produce code a bit faster now thai you are able 
la forget about matching up braces or typing out i!ie words 
lK*gin and end all of the lime. ibu,s. Python ensures a 
ceriain amount of ct>n.sisteiuy across developers and 
provides a certain amount of iaeviiy for the .single 
developer. 

Next, and one of my abs<j|ute favorite features of ilie 
language, is the availability of t!ie language an nearly every 
platform. At htmie, I do all of my clevelofrtneni on an Apple 
Powerbook running Mac OS X vHJ.A {Panther), At work, 1 
do all t)f my developmenl on a Dell either running Window,s 
XP or Redhat Linux. On all of these plath>niis I am alile to 
use Python as my scripting language of choice. What this 
means is ihm a program 1 write ai home can be pniied over 
to my work computer wiihoui any fus.s, and vice-versa. 
Throw in the availability of .several cro.s,s-platform GHl 
libraries for Python, and you have a complete solution for 
developing applications that can be used on virtually eveiy 
popular operating system and computer archilecture in use 
today. 1’his also means that programs you develop will be 
availalile lo a larger audience, than say; a program 
developed using Olkeciive-G and Ckjcoa. 

The final ad%^antage Tve listed declares quite a bit in one 
statement. First, you should know I hat Python has been 
around ft>r a while, IPs I'leen around long enoLtgh to have 
developed a strong and very loyal following {in fact, the 
computing powx^ rhou.se, <kx)gle, asks for I python experience 
in nearly all of their empUjyees. Now that's an 
endorsemeni), but just shon enough to still be considered a 
n 1 C )dern pre igra mming 1 a ngi i age. 

Initially developed around 1990 at ihe CWl ta 
research institute speciali/ang in maihemaiics and 
computer .science in the Netherianils) by Ciuido Van 
Kos,sum, the language has been widely accepted tiy the 
programming community, especially those involvetl in 
sy.stem administration, the Open Source community, and 
lire luicker community (as desc.ribed by Paul Ciraluun in 
his es.say “Great Hackers O, 'Hie language has a very 
strong following and because of this, it is always evolving 
and gaining new libraries and a hi I tries. It is tlefiniiely not 
a dead language, and in fad. il is curretrtly imdcr the 
control of the Python Software Foundation, a group that 
is tied tea tcil to the atK an cement of open source 
technology related to the language. It s also nice to know 
that at the helm of this foundation is the creator of the 
language himself. I’his amount of support ensures ihai 
thon has a large ccjmmunity of developers available for 
help and t|uestioning as well as libraries for nearly every 
need imaginable. 
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So, now dial you have a good overview of the Python 
language and what it can do for you as a developer, you may 
want to take the time to aaually learn the language. If youVe 
cheap, or perhaps just l>mke, you're in luck. Just like any other 
language popular amongst hackers, Python has quite a laige 
numter of online tutorials, references, sample programs—you 
name it. Just alaaii everything you need to learn the language 
am be found for free on the internet. Youll definitely want to 
check out the tutorial on the main Python website 
lhttp://vwvw,python.oig/dod23.4/1iJ^^^^ and after youVe got the 
biLsics down, you may also want to check out the Python 
Cookbook lhttp://aspn.aaivestate.com/ASPN/Python/Cookbook/l to find 
some nice recipes for your own development. 

I'll go ahead and make the assuniption tliat since youVe 
read this lar, I've already piqued your interest enough to make 
you w'ant to go out and learn the language. However, if you’re 
going to learn Python you might as well do it in style. Tliat's 
wliere the rest of the article comes in. 

Tlie remainder of this article is going to go over some of 
the code editors and IDEs that you ran use on OS X to develop 
your Python seripLs. So, get out your laptop, or fire up your 
desktop, grab yourself a nice cup of coffee, or whichever 
caffeinated life support—err...T mean beverage—you drink 
regularly, and get ready Ui start some dtiwnloading. After all, 
you don't want to be the last one on your block still using 
TextEdit to write your Python scripts, new do you? 

However, Before We Get Started... 

Before we get started with our journey, however, we need 
to make sure that we are all starting on tlie same page. The Mac 
OS, fnjin alxjut vlO.2 smd above, has come widi a 

preinstaDed version of the Python programming language. 
However, at last check, the version that came with the operating 
system was v2.2. So, Ixffote we get started with our journey into 
lire wonders of Python on tlie Mac, we need to tlownload and 
install the latest version of the Python programming language 
(v2.3 as of iliis article's writing) wliich can lie found at the 
MaePython website !http://homepages.cwi.nl/'“jadc/maq)ython/]. 

Once you’ve got the latest version of MaePython installed 
on your sysierti, youTe ready to start playing around with 
Python. But, before we can do that, tliere is still one last 
problem in need of a rest)luiion. 

Many nf the IDEs dial we will l>e reviewing in the next 
seciion of diis article were developed in Python using the 
wxPython GUI library. So, in order for us to use these 
applications weVe going to need a copy of wxPydion iastalled 
on (Jur system 

You can dowmioad a copy of the most current library 
from its homepage lhttp://wTtpython.org/], however, you'll 
find that if you install the mo.si up to date edition of the 
library, the Boa Constmetor IDE that we will discuss shortly, 
will not am. In order to make use of Boa, you1l need an 
earlier version of wxPytlion: w^xPyihon v2j12.4. To get a 
copy of this version you 11 need to download it from the 


Sourceforge repository at the following address: 
http;//sourcGforge.netyproject/showfiles.php?groupJd-l0718. 

Luckily, the install is extremely easy, since, both die 
current version (v2.5.2.B) and the earlier version (v2.4.2.4) 
have installer packages made for them, All you have to do is 
download the package at the aforementioned URL and follow 
the steps to get it installed. 

Once yoiiVe got the current version of MaePython and 
wxPylhnn v2A2A installed, you’re ready to start 
experimenting with the myriad of development tools available 
to the Python programmer. 

Code Editors And Integrated 
Development Environments 

Well, now that we have downloaded and installed a copy 
of MaePython and the wxPython GUI libmries on our system, we 
should !>e able to try out some of the development environments 
available for Pydion. Several possibilities exist for the Python 
developer looking for an IDE or a simple ctxle editor on tlie Mac 
and this section mtrodut:e.s tjuite a few of each. 

Fc^f anyone who’s kx>king for a simple code editor for 
Python, the choices are nearly limitless and most are quite 
good. In this category, well lorik into a couple of classic and 
powerful editors lliat already ctime with your system: Vim and 
Einacs. How'cver, if your interests lie in finding a full IDE 
comparable to Apple’s Xcode or Microsoft’s Visual Studio, Boa 
Constructor, or the Wing IDE should suffice. Well cover both 
of these options and we'll even IcK^k into ways that we can use 
Xcode as our Python development environment. Finally, well 
review a RAD tool that allows us to t|uickly develop wxPython- 
based GUIs without writing a single line of code. As a bonus, 
ilie latter application should be useful to any Pytlion developer 
using the ^rxPyilion GUI library^ regartlless of which code editor 
or IDE tiieyVe chosen to use. 

So, lets get started by taking a look at a couple of options 
for tliose of you just wanting a simple code editor that supports 
Python development with simple features such as syntax 
highlighting and perhaps automatic indentation. The first 
section covers the powerful and popular editors Emacs and 
Vim and discusses how to get them lo grok Python, 

Emacs and Vim 

If what you're looking fcjr i.s a simple code editor, dien 
yon1l find that a few come already installed and ready for work 
on your computer right out of the box. Mac OS X comes with 
tw"o very popular and very powerful command Line editors: Vim 
and Emacs. Both editors undersUmd PytJion and can be coerced 
into providing syntax highlighting with very little effort. 

I fired up Vim for the first time the other day just to try 
it out and see if it wmrked with Python, and it did perfectly. 
In fact, all 1 needed to do to add syntax coloring was to type 
isyntax on while in command mode, and Voila, beautiful 
syntax coloring right from the command line. You can also 
add that line (sans the preceding colon) lo the .vimre file in 
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your home directory if you wish to aiwiiys start the editor 
with syntax coloring turned on. 

While many developers love Vim and wouldn't be 
caught coding with anything else, I personally find it to be a 
bit daunting. I learned to program on Emacs from the 
command line and I still prefer Einaes to just about any other 
code editor. Ids powerful, easy to use, easy to customize, 
and it comes free with Mac OS X just as Vim does. Also, just 
Iil<e Vim, if you prefer to see your code in color, you’ll need 
to tttm on syntax highlighting by hand. 

To turn on syntax highlighting in Emacs, you'll need to 
type M-x global-font-lock-mode once you've started the 
application. (Note: By M-X, 1 [iicaii to use a combination of 
the Meta key and the x key. For the Mac, the Option key or the 
Escape key can act as the Meta key while in Emacs.) Orherw'ise, 
if you like to open your editor with syntax highlighting already 
turned on, you can add (global-font-lock-mode 1) to the .emacs file 
in your home directory. Make sure you include the 
surrounding since Emacs uses a version of the Lisp language, 
called elisp, for configuration and scripting. 

If you've added the global-font-lock-mode line to your 
.emacs file and syntax txjlodng still doesn’t seem to be 
working, it may Ixjcause you forgot to add the .py extension 
to your file and youVe left out the optional she-bang line at 
the top of your script, thus the editor has no way of knowing 
dial you just opened a Python file. The same is also true for 
Vim. You should be able to remedy the problem, however, by 
either adding the she bang line to the top of your script telling 
the sliell which program is used to run the script, or by adding 
the .py extension to your file’s name. If you choose the former 
option, the she-bang line should look something like this: 
#!/usr/bin/python. where, /usr/bin should l>c replaced wiili the 
path to the Python executal.iie on your system, which you can 
find by typing in which python in the Terminal application. 

However, if you have your emaG file setup correcily and 
you also have die appropriate extension and/or she-bang line 
and yet Emacs still does nor work correctly, it may be because 
you don’i have a definition fora python-mode on your system. 
You may need to download an elisp file that defines the python¬ 
mode and install it. To do so, download python-modaei from 
SourceEorge.net at http://sourceforge,net/projects/python-mode/ and 
add the following lines to your .emacs file in your home 
directory. (Note: inake sure to use the correct path to the 
location of your python-mode,el file in the load-file command, rather 
than the one I've supplied here.) 

Listing 2: Adding python-mode Ki Fmacs 

*emacs file 

Tlie tblU>wing lintij ertate a variabJe that holds the 
location of the pythoti'modc.el file, loads the new nxKle 
into Uinacs, anU associates iljc ,py extension wiih tim 
mode. 

(load file "^/sw/lib/python^ .3/Nist:/pythorL-mode.el“) 
(autoload ' python-mode* "python mode" Python tnode,“ t) 
(add-to'liat 'autO'mQde’alist *("V.py** . python-mode}} 


Now, T realize that ntJi everyone enjoys using 
command line editors. Many programmers have growm 
up in a Windows environment where the idea of doing 
any serious work from the command line is laughable. 
To liiose of you who feel this way, I would like to suggest 
that you still consider giving these command line editors 
a uy. Remember, your working with an interpreted 
.sc:ripiing language when wwktng with Python, and for 
that reason, you will find yourself wanting to use it for 
several small tlirowaway programs that will quickly run 
from the crommand line to accomplish a task or two and 
tlien be dcslroycd. Wlicn writing quick and disposable 
programs, I find it’s generally fastest to develop from the 
command line rather than resorting to a full IDE. That 
said, it’s not a bad idea to use an IDE when develo]5ing 
larger, more complex programs rather than quick scripts. 
For those of you who wish to u.se a complete IDE for 
those tasks, I’ve listed a few choices Ixiow. 

Boa Constructor 

Probably the mosi popular and intjst powerful Open 
Source IDE for Python (at least of the I13Es that work on 
OS X) is tlie Boa Constmetor IDF. This program is a fully 
loaded IDF, with project management and a RAD tool for 
generating GUI code (w^Python code only). But, as 
good as diat sounds, 1 did find a few problems when 
working with tt. 

First, I found it to be a little slow and Limes ponsive. 
Lm i-uniiing tills program on a G4, b25Mh7 PowerBook 
with 1GB of RAM, and yet it still feels a bit .sluggish. So, 
I don't see this as being a productive environment for 
anyone not amning on a top-of~the-line Mac (preferably 
a GS-based PowerMac). 

Second, the way the GUI was coiistaiaed disturbed me 
a bit. Basically, you hid tliree main windows w^hen starting 
a project, all of them disconnected from the other. So while 
you were working in Lfie main editor window, tlie rest of tlie 
windows would gray tliemselves out imd move to the back. 
This truide it feel like three separate programs rather tfian 
one. There may be .some way to resolve tliis, by tuniing on 
dcxking or somclliing, bLit 1 was unable to find a way and 
it just left me frustrated. 

Finally, Boa Cc.)nstrucU)r is written in Python using 
the wxPython GUI toolkit, which was our reason for 
download and installing the wxPython library in the last 
section. However, Boa ConstmcLc^r does not work with 
the latest relea.se u{ wxPython, w'hich at this writing was 
V2.3.2.8. Instead, you have to download and install 
V2.4.2.4 of the wxPyThon GTIT library (just as we all did 
during llie imroducuon) in order to run tlie IDE. This is 
of course a minor setback and 1 believe that work is 
currently being done to update Boa to the newest release 
of wxPython, but for the Lime iKnng youVe stuck with the 
[previous version and it is a bit annoying. 
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Figure 1 - The Boa Constructor IDE 

In short, Boii ts about tho only choice you have if your 
looking for a fLill-riedged, l>atterics intluded lUE written 
specilically tor Python, witli a RAD tool and all. However, with 
its sluggish response and unfriendly tJl, 1 hnd myself reticent to 
recoininend it to anyone just yet. i simply feel that it's not quite 
ready for prime time. 

Nevertheless, if yoifre ninning a top-of-ihe-line machine 
with plenty of memory and clock cycles to spare and you want 
a full and powerful IDE, you may as well give h a try (after all, 
it is free). But, for the rest of us without the means to hy a dual 
prooesscjr PowerMac G5, Ell press on and discruss some editors 
that 1 do find worthy of looking into a bit closer. 

Wing roE 

If you're looking for an IDE that’s developed specifically for 
Python and runs like a professional iooi shoiikf then you can 
look no hinher than Wingware's Wing IDE. In the previous 
section I said that Ikxt was proirably the most powerful IDE that 
I'll cover in this article. Well, personally I prefer the Wing IDE 
to Boa, and I find it to lie nearly as powerful as the Boa IDE. 
However, one area in wJiicIi the Wing IDE falls just a bit short 
of the l3oa IDE is in its exclusion of a MD tool for GUI 
developmenl. With that said, I do believe that what the Wing 
IDE does...it does Ixnter than Boa, and for tliat reason 1 prefer 
it to Boa, or for that matter, to any of the other IDEs Eve tiaed 
for Python, Pkis, if you absolutely must liave a RAD took you 
can always use the Wing IDE in conjunction with the 
wxGladeOSX GUI designer tliat wee'll Ixf taking a look at shortly. 
But, before we get to our free RAD roof let’s take a closer look 
at Wingwarc's Wing IDE. 

During the time tliat I spent with the Wing IDE, 1 found it 
to run smoother, look better, and just feels a bit tighter than the 
Boa Constructor IDE. Wing TOR has coda completion (one of my 
big requirements wlien using an IDE) that actually works, in 
other words, it helps you code rather than get in your way. 
Nevertheless, Wingware's IDE does have a few problems that Ell 
go over in the next few paragraphs. 

First, the application utilizes X windows for its window 
management, so it will need XI1 (or some other implementation 


{)f X windows) to mn. Though I prefer to run my applications in 
Apple's native Aqua look and feel rather than using XI I, the IDE 
still looks really great. Unlike most programs using X, it acaially 
looks as if belongs on OS X. 

Second, just like Boa Con,structor, the Wing IDE was 
developed with Python and wTtPython, and just like Boa 
Constructor, it nins a little slow. Surprisingly though, thi.s one 
dcx\sn’l run nearly as slow as I would have ex[x:ctcd considering 
the complexity of the progmm and of course the fact that die 
progi-am is being aaively interpreted latlier than ran as a 
precompiled cxecutalile. So, while it is dehnitely slower than say, 
a compiled Objective-C progiam using Cocoa, ids not so slow as 
to make k unusable. 

Thirtl, the pi-ojeci management features .seemed a hit clumsy 
when compaied witli other IDEs IVe used. For example, when 1 
created a new projea, 1 was not presented with a wizard to choose 
die Itxation anti name of my new project, a.s i.s the case with mmi 
IDEs. Instead, 1 hatl to chtx>se Save Project As... from die Project 
menu—after 1 liad idready created die prt)jea—and rename die 
pnjjtxi and cIkkxsc ii.s kx'ation. Plus, you'll ntx:d to create a folder 
for your new [jrojecl as w^ell, cxlierwise you’ll find your files scattered 
^dl over die directory in which you created the project. Also, when 
adding a file, youYe cemfronted with the same sc^enario as when 
creating a project. Once again, you must chtxxse Save As...from the 
Project menu to designate a name anti kx^adon for the file—after 
you’ve alruidy created it—^and you have nin tlirough the entim 
directory strutlure again to place it in the same l(x:ation as the project 
rather itian the default Ix^ing to place the file in die project’s folder. 
Oixv. you've created your file, named it, and chosen its location, it 
is still not yet pait of the projea. You musi choose Add File... from 
die Project menu to finally add die new file to your piojcxt. None of 
this is esjxxtally hard to do, but it's not the most intuitive or efficient 
process and it’s definitely not a very usei-friendly design. 

Finaily, the Wing IDE, unlike all of the other editors and 
development environments 111 mention in this article, is not free. 
Luckily, it doesn’t cost very much for a hobbyist just wanting a 
decent IDE on wliidi to develop ihcir [python applications. Tn 
fact, as of this writing, the personal edition of the IDE could be 
purchased for $35, and if you definitely iniist have an IDE, I see 
no reason why the Wing IDE couldn’t fill that void for you. 
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All in all, this is probably my favorite of ilic IDEs develojx'd 
specifii'ally for llic Python (irogniiniiiiiig language. 1 wish it ran 
just a bit faster, and it would Ix^ nice to see someone develop a 
Cocoa based Python editor, bin until tliat happens, I would 
ret'ommend this IDE to anyone searching for a nice Python 
development tool. Plus, you can download it and try It out, fully 
functional, free of dmige for up ro ten days. So, wliy mn take it 
out for a spin and make your own judgment call on whether or 
not ifs worth the money. 

Eclipse With I^Dcv 

Eclipse Is many things: a genetic development environment, 
Java IDE, platfbnn for tool development, GUI liixary—ihe lisi 
goes on and on. in fart, Eclipse is so large that several 
publishers fiave released entire lxx>ks on just using it elTeaively. 
For our purfxxses though, we can just think of Edipst* as an IDE 
that can accommcxlate any language ff>r wiiich an extension has 
been tieveloped. tVliion iiappcns to lx; one of tliose languages, 
and PyDev is the name of the extension that prrwides Eclipse 
with the ability to grok Python. 

PyDev lags iLself as a contpleie devebpmenl environment 
for Eclipse. It consists of three plugias, Ihe first is the editor 
plugin and it supplies the user with helpful features siicli as 
syntax highitgliting, smart indentation, and a whole list of the 
usual susjxcts- It claims to support crxle completion and 
refactoring as well, however, in my tests 1 found Ixjth of these 
features to bt* somt:what buggy. One feature of tlie editor 
plugin tliai I did find to be very helpful was its ability to ca]:>ture 
syntax errors on the fly. For instance, if 1 tried u> concaienaie 
two strings, Ixit i accidentally lell out tlie sign, tlie variable 
containing the second string would be underlined with a 
squiggly red line (reminiscent of most word prexessor's spell 
checking fetiture) to alen me that my syntax wiis incorrect and 
liiai the inier|)rL‘ier w^as ex|3ecting something other than just two 
operands, one right after the other, 

'Ihe seexmd plugin is the del^uggcn Tliis plugin [>rovicles 
Eclipse witli your typical code debugger, providing the user with 
a way to step through their code using breakpoints and l(K)k at 
variable values and so forth. 

Tlte tliird and fmal f>lugin of the PyDev development 
environment is tlie help plugin. This supplies the user wi\h 
some Ixief, Eclipse style, documentation for l^yDcv. 

Will^ regards to Ixing a proj>er development enviromiient, 
the PyDev and Eclipse combination seems to be a formidalile 
solution. If youVe dead set on tising an IDH to develo(> your 
lVhf>n appliotions rather tlian a code editor like Emacs or Vim, 
and yet you don’t want to spend the money to purclia.se the 
Wing IDE, then I would recc^mmend this one over any of the 
others IVe reviewed in this article. I haven’t worked with this 
setup for very long {ns 1 said earlier, my favorite environment is 
Emacs right now) but 1 have used Eclipse quite extensively in 
the past wiili Java (in fact. Eclipse Is iiiy IDE of choice when 
doing Java development) and I luive found it to be a very gtxxi 
IDE. Plus several major companies in the software industry liave 
been trying to standardize on Eclipse for their IDEs. You know 


wlien companies such as IBM and Wind River (creators of tlie 
popular emlxilded OS VxWorks) arc using Eclipse that it must 
lx‘ a gcKxl environment. 

71te main thing to remember is that I^Dev is ajrreniiy in 
version 0,8 (if has not yet reached version 1.0), and as such, it is 
still in iis Ixginning stages. So, it's a little rough around the 
edges. Nevertheless, what it dcx?s...it does well (with the 
exception of features that are still in ihelr infancy), hut it docs 
need some polish Ixlbre it will feel like a fully functional l^tlion 
develtjpment environment. 

Xcode 

Finally, i want to go over a couf>Ie of ways diat you can 
make use of Apple's Xcode in your 1-^yihon tlevelopment. If you 
choose to go with this option ytruJl find that you have two 
scluxils of tliought: 1) you can create pure PyTht)n applications 
(i.e.^ cross-platform, not dependent on Cx>coa), or 2) you can 
create OS X mitive applications using PyObjC wiiJt CtKoa. Well 
first cover creating and running a platform-independent, pure 
Python application, and then we’ll look into wlial PyOhjC is, 
and what it can do for us. 

When playing around vvitli Python one day, I finally 
reached a point when I thought; hey, woukln't it be great to 
develop in Xccxle. After all, I’ve done some dcvck>pnieiU witli 
Xcode, mainly just teaching myself AppleSc'ript, but 1 was, 
iiQiietheiess, quite impressed with the environment, ft was fast 
and efficient and, unlike other IDEs, it didn’t get in my way 
wlien i wiLs programming. So, 1 started searching the web for 
a way to setup Xcode for Pydion developmem other than just 
using the PyObjC bridge to develop Cmoa Irascd apj>iicaLiQns. 
After a bit of kxjking, 1 eventually siumliled across a site called 
pyx (Pytlion on OS X) and it iiad some tiirections for setting up 
Xctxie for this very’ task. In the next ample of paragrapiis I'll 
share with you a cjuick summary of llie infomiaCion 1 garnered 
from that site, (By the way, the webisie's URL is 
http://ulaluina.com/pyK/, it's worth a kK)k every now and then to 
see if any new and luseful information lias lx;en reported.) 

First, let s start off with developing a l^ython command line 
application. 'Die process is pretty simple. You basically just 
need to setup an empty project (since Xcode does not directly 
sup[>on Pytlion development) and create a custom executable 
to run your application. So, if you follow the steps I’ve detailed 
below, youJI be up and running in Xcode in not time. 

1) Choose rile->New Project to create a new Xc:odc project 

2) JVLtke sure you select Ktupiy Project as the ly|>e of project to 
create 

3) Choose where to save the projed, name it, and click Finisli 

4) Add your main file to the appliaition 

5) ChtKxse Projcci->New ctistom executable 

6) Name your custom executable and type in the path to tlie 
python executable on your system (yoti can type which 
pytlion in die tcrtniiiid window to get this inlbrmation) 

7) Double click on the custom executable you created to open 
its main intormation window. 
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8) Click the arguments tab anti click the *+’ button to add a new 
argument to the list, 

9) T!ie new argumenl .should be tfie complete path to the main 
hie of your application (you can either find this patli using 
Finder or the Terminal application) 

10) Choose Debug->Run Execuiable or Pres,s opi-command-r to 
nm the application. 

Running a Python application that it.ses the Window 
Manager is essentially the same as running one from the 
command line, however, we need to tell Xcode to use pythonw 
instead of python (pythonw is needed to run a Python script that 
makes use of the Window Manager, i.e., a GUT-based 
application). Ihis is where we nan into a small problem. It 
seems that Xa^de only wants to run a binmy executable, 
which python Ls, and pythonw most definitely is not. Since 
pythonw is a simple shell script we can run it by passing it and 
the file we wish to execute as arguments to the sh program, 
Using tliis method, our new executable path should look 
something like the following: /usr/bin/sh /usr/bin/pythonw 
/path_to_main_file/filename.py. 

Anotlier way that we can nin our GUI-based appliaition is 
to put the full path to the execuial)lc that i.s relercnced within the 
pythonw script into the executable path of our custom executable 
that we c:reated in our Xcode projea. If you prefer this method, 
youtl fii'St need to get the location of the pythonw .script, wliich 
you can do by typing which pythonw into a Temiinal window. 
Once youVe got the location of the pythonw script, you’ll need to 
oj^en the script with your favorite editor or display the contents 
of the script witli the cat program and copy and paste the full 
path to the Python executable from the pythonw script into the 
executable path of the aisiom exectitable we created to am our 
application. Once you've done tiiLs, you’ll be able to nm your 
GUI-based Pytlion programs diretlly from Xcode, 

tf you like Python and you don’t really caie to neate 
platfonn agnostic applications, you may Und that developing 
Python appliaitions with PyObjC is the most logical environment 
for you. PyObjC is an Optm Source project that provitle.s a 
bidirectional l:)ridge I jet ween Pyllion and Objetajve-C. Thus, 
Pytlion programmers have a way of accessing the classes of 
Apple’s Qxxja Framework through this bridge. One of the most 
iinfxjrtant uses of this is to provide the Python prognimmer with 
access to the Cocoa GUI classes allowing him/1icr to write OS X 
native, Gin-based applications in pure Python. 

My experience with PyObjC has been promising, though I 
still believe tliai it needs a few' more itcTaiion,s Ixjfore reacliing 
the usability 1 prefer in a development environment. For 
example, I wish it were possible to generate the pydion files 
from Interface Builder as you can for Java and Objective-C 
rather than going to the command line to do so. Small gripes 
such as this aside, I did enjoy developing applications using 
PyObjC. I found it Uj lx: very usable, very stable, anti very easy 
to install. In fact, binary installers arc available for Ixjth Jaguar 
and Panther editions (vl0,2 and v,10.3) of OS X and can be 
down It jaded from the projects main w^ebsite 


Ihttp://pyobjc,sourceforge.net/]. 

If you’re planning on developing applications for other 
platforin.s as well as OS X, then obviously this is nor the option 
you should gcj with. Hcjwever, if you enjoy programming in 
Python and you’re looking for a way to use it to develop OS X 
native applications, or if youVe jirst looking for an alternative to 
Objective-C, then PyObjC may just be perfect you, 

wxGlade 

Before we close out our discussion of code editors and 
IDEs, ] wanted to go over one final option tliat is neither code 
editor nor IDE, but it does seem to fall into a similar category. 
The wxGlade designer is a ttAD tool that can be used to design 
GUIs for your Python applications using the wxPyihcjn lil>rary. 

'I'he application was created using Python and the 
w’xPython GUI library. It can be used to rapidly construct a 
graphical interface using the drag-n-drop meiluxlology that 
other popular RAD tools use. Once the GUI is completed, 
wxGlade will output the code used to create tlie GUI. This code 
can then lie plugged into your applic*ation and y<ju can then go 
about adding the code that does the actual work saving you 
countless hours writing the code that creates the applications 
GUI. 

The designer isn't just limited to prcxlucing ajde for Python, 
however, llie w^xGlade GUI designer also produces wxWidgets 
cxxle tor the C++ aixl XRG (an XML Ixised code format) languages 
as well. This means that, shoiiid you ever becxjme interested in 
using your knowledge of wx’Widget.s to develop cross platform 
applications ba.sed on another hinguage such as C++, (say, if more 
speed is needed) then you'd already have the ability to do so. So, 
Irasically more Ixmg for the buck—nice, eh? 

Hie wxGlade GUI designer was based upon Glade, tlie 
CjTK/Gnome C31J1 Builder. It's definitely not the most intuitive GUI 
development tool to use, so ii will take a bii cjf training to Ixxxjmc 
an expert with it, but it’s free, and once le^inied, it does speed up 
tlie process of writing a GUI quite a bit. Also, it has a %^ery simple 
install since a binary {tailed wxGladeOSX) has lx:en crcaied and 
can be fountl at die WoiTcITech website [hltp://www.wordlech’ 
soflware.com/Wxglade.htnnli 



Figure 3 - wxGladOSX With Code Displayed in XEmacs 
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Conclusion 


As the title would, suggest, this article was meant to be a 
very gentle introduction to die Pytiioo language and to what 
Python has to offer Macintosh developers. Hopefully, if I’ve 
succeeded in my job, you'll come away fnim iliLs article with an 
interest in learning Python and youll l>e amied with a whole 
slew of development envimimients to aid you in the pnjcess. If 
this is the case, make sure that you mne in for my second article, 
which promises to probe deeper into die tools available to the 
Python developer on OS X. 

Unlike this tiionth's article which was geared towards 
Pydion newbie's, next month's anicie will lie geared to those of 
you already employing Python in your development routine. 
Those of ytJU who hill into this group, will be introduced to 
several libraries that svill make your use of Python easier and 
more effective. 

So, until then my new Pythoneers—best washes in your 
Python development, and happy .stTipiing. 


Website Not Found By Clients 
HTTP 404 - Website not found 


The website you are looking for can't be found 
by your clients. It may have been improperly 
marketed, had poor design, or didn't work. 
Regardless, it’s not helping your business! 


Your Options: 

• Rent a chicken suit and stand on the 
corner handing out flyers 

• Paint the company URL on your chest and 
face during a major sporting event 
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THE SOURCE HOUND • by Dean Shavif 


A Smart World 
After All 


At the time, 1 wasn't wliat une would aiW 
a ‘"c'ompiiter profe^iomil," though 1 did mm 
consulting work in the nmi of Desktop 
Publishing, training on QuarkXpress ami 
IlliLsirator, and managed to sulisidixc iny 
desire It) bea)me a poet while sullering as a 
poor grad student. Tliough 1 w:is <iuite aware 
of eeitain signs of hard disk tix>ul:)le, such as 
**sUcklion,“ whk’h would delay startup, or die 
^'wliine," whidi indicated lieiirings that were 
about to go, my tmsty FowerBcxik 520c 
extubiLed no signs of any disk piToblems, not 
one disk errtir, ntx one Irad secior Its haRl 
drive died suddenly, without even a htxirse 
whisper Tm really not w^mng |x>etic; Ixtck in 
die tiiid 90s, the only r«d clues tliar a hard 
drive was dying (otlier dian die cx.'casional - 
36 disk error or Ixid sector turned up by a 
disk utility), were audible {a scratch, a ping, a 
scrape), so tlie hyperactive herky-jerky 
animation of Dr. Peter Norton rubliing fits 
stedioscxipe over a hard disk platter in Norton 
Utilities 3 wasn’t really that far horn the reality 
of troubleshooting a failing disk. 

Ii was rather amazing how accepting I 
was of the situation. 1 turned in my books 
and moved on to a career in Macintosh 
technology. I took responsibility for Ix^ing 
a dummy and not backing up. 1 never once 


ihought to ask, how come my Mac didrvi alen me that there 
was a problem with my disk? In 1996, we didn't have such high 
expectations of our personal computers. We wanted them to 
work, to print, and sometimes to connen to a network, A ceil 
phone or pager was a luxury, and email accounts were 
generally bimdled with a job, or student enroilmenl at a 
University, or an AOL or CompuServe memliership. 

Besides my life-changing data lt>ss, it seems iliat 1996 was 
u pivotal year for hard disks in general In April of that yc^ar, 
a group of researctiers from several drive manufacturers was 
busy hammering out version 2.0 of SFF-H035j, a standard for 
hard drive diagnostics which had been pruptised the previous 
year, defining thirty attributes related to perfarmance and 
reliability that hard disks should track internally. The 
standards they developed became known as the Self- 
Monitoring, Analysis and Reporting Technology systems, now 
referred to as SMART. 

Disks Will Die 

One of the biggest issues Veterinarians have is that the 
pets llic'y treat don't have the ability to communicate specific 
symptoms of disease. Dogs and cats writh organ failure 
generally don’t complain alxmi pain, but simply seem to slow 
down, not run as fast, or jump as high. No matter how 
perceptive the Vet, or how experienced, I’ve often heard them 
exclaim, “1 wish the animals could tell me what was wrong.’* 
How strange would it l>e if, like an automobik*, tlie pet had a 
diagnostic port that would reveal a score about how well their 
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H aving a hard drive die on you can be a life-altering experience. 

ni never forget tlie first time it happened to me. It was 1996, 
and I was sitting, drinking an espresso in a local coffee house, 
working on an essay for my Ph.D. comprehensive examinations 
in English, when my PowerBook 520c froze. I didn’t think much of it at the 
time, as I was running System 7.5, which tended to freeze without warning, 
but when I rebooted, I found myself staring dumbly at the blinking question 
mark. Hours later, after mnning Norton Utilities, and seeing that my l60 meg 
hard drive was now recognized as an 80 meg hard drive, I realized that my 
essays and research were lo.st. Sure I had a two-week old backup, but I’d 
been in a frenzy, working hard to make a deadline, and hadn’t thought to 
keep my backup current. I took it as a sign, and even tliough I’m 
occasionally called “Dr. Dean” when I show up on-site to troubleshoot an 
ailing Mac, there’s now no other reason to call me Doctor. 


liCLirt or kidneys, or intestines were fuiiaioning? AiiEomo[>iles 
have such diagnostic ports, and some older (much much 
older) Macs used to have them as well. 

Hard disks are mechaniail devices, just like Zip disks, r>r 
floppy disks. Tliey have mocois. Tliey have platieis ihai rotate ai 
speetis that would make the engines in m<isL ous oveiiieai and 
explode. They have little arms mih magnetic heads that dance 
around picking up blocks of data. Frankly, It's an amazing 
tesuiment to tlie engineering skills of hard disk manulactuiers that 
they ;tre as reliable as they am. With OS X, hard disks will ga even 
more of a workout if there's not enough ItAM in.stalled in a 
machines, due to virtual memory page outs, leading to a premature 
demise of tlie startup disk. 

Most end-users and far too many system administraujrs 
don't realize that current hard disks are keeping an internal log 
of their own performance, based on the SMART attributes 
codified and updated with the ATA-3, 4. and S standards. 
Mtxlern SCSI disks also have SMAK'I' capahililies as well. Some 
of the attributes that SMART tracks are: (see table) 

SMAR'l' attribute implementations still vary, somewhat, 
by manufacturer, but they have enough in common to, at the 
very least, give a pass/about to fail status report when 
queried. Starting with OS X 10.3, Apple's own Disk Utility 
includes a simple SMART test, which will display a one-line 
S.M.A.R.T status report when you select a physical disk: 


rm 

1 

2 

3 

4 

5 


6 


7 

8 
9 


Afrnluife 
Raw Read 
Error Rate 

Throughput 
Performance 
Spin Up Time 

Start/Stop 
Count 
Reallocated 
Sectors Count 


Seek Error 
Rate 


Seek Time 
Performance 

Power-On 

Ilours 

Internal 

Temperature 


DescriptUm 

Count of non-corrected read errors. 
More errors (a smaller value) denotes 
a deteriorating disk surface. 
Throughput (I/O) performance of 
Ifard Disk. 

Spindle spin up average time (from 
parked to ready). 

Cycle count of spindle start and top. 

Count of reallocated sectors. A gn^at 
indication of a failing disk. 
Reallocated sectors are marked as 
■^unusable/" which is why modem 
hard disks don't show bad sectors. 
Count of seek errors. This indicates 
errors when tlic heads have a 
mechanical failure or when tlie heads 
positioned over a data block cannot 
read it due to ptxir disk surface 
conditions. 

If this attribute is lower, it indicates 
mechanical problems with the heads 
or disk surface. 

Total of many hours the drive has 
been powered up. 

How hot the temperature sensors say 
the drive is. Can also be a great 
indicator of how hot the inside or a 
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Figure K 


The SMART !c,si Ls also available from the Terminal in OS 
Xf via the diskutil command, which is specific to OS X, First, 
you have to get the hard drive identifier: 

mininei"' deaTi$ diskutil list 
/dev/diskO 

#: type name size 

0 : Apple pflrtltloti^scheine * 74.5 GB 

1 : Apple^partliJun_map 11.5 KB 

2 ^ ApplOFS Dean 74.4 GB 

miniine;'- deari$ 

In I his case, ihe hard disk identifier is diskf), where as 
the volume identifier is disk0s3* Working with the hard disk 
identifier, we can then query diskutil to get info on the drive, 
wltich will include the SMART Status: 

utlniiiie:* deaii$ diskutil info disk{ 3 |grep 1 ainart 
SMART Statue: Verified 


identifier 

diekO 

diekOsl 

diskOsB 


Note that in piping to the grep command, I use the -i 
switch to turn off case sensitivity. Diskutil is very useful for 
shell scripts, such as the one 1 wrote below: 

tfl/bln/sh 

script is deslgfjed to get the SMART status of a drive and send an 
email notice on fait 

** !0 test, change the "g!Dod=l" below to "gDOd^O” and you should 
receive a warning email 

** DeanShavit. MOST Training & Consulting dean€^macwcrkshops-com 

http :/Avww.macwQrkshDps .com 

##This is for OS X Machines withATA drives ot% 

## 

## Step 1: Define a variable for a functional drive by counting the 

number of SMARTVetified Disks 

status**'diekutil info diskO|grep -ti verified' 

Step 2: Define a number for comparison against a failed drive 
good=l 

Step y Define the warning message for the body of the email 
warning**'Houston ve have a probleml' 

*# Step 4: Define a variable for the computer name 
b ox^'? u s r/sbin/sc u 111 ■ get Compute rName' 

Step 5^ Define a variable - email address of person to notify 
adriiin“"dean@siacvorkshops. com" 

## Step 6: compare curieni status with good status, if a match, echo. If 
not, notify 

If L Sstatue ““ $good 3 : theo 
echo Sstfitus 

else echo From: Sbox- $warDingtn > /tmp/houston.txt| mail s 
"SMART Alert Report" $admin < /tntp/houston.txt 
fi 

done 


This script, when run as a cron job, will check the hard 
disk periodicafly ft>r SMART status and email you when die 
drive when the drive has a problem. There are two status 
codes that Disk Utility can report: “Verified" if none of the 
SMART attributes exceed their normal thresholds, or "Abtjul 
to Fair which will appear in red tetters, indicating that the 
drive will fail and should be replaced. Of course, failed" 
isn't a status that the drive can report, but is a stale! It is 
important to understand that even If the hard disk passes the 
SMART test, there's always the chance that the drive might 
suddenly expire, without ever issuing a warning. The SMART 
tests are diagnostic tesLs, and should never be used as a 
replacement for a good backup sirategy. If anything, the 
advance warnings will help indicate when a drive needs to 
be replaced, so as to minimize any possible downtime of a 
server or workstation. 

For those who don't want to script or want an easier 
path to SMART notification, there's a great donationwarc 
utility called SMARTRcporter downloadable at 
hltp://homepage.macxom/iulianmayer that provides a nice 
Cocoa GUI for accomplishing the same scheduled diagnostic 
and warning email, witlioul having to use the Terminal. For 
tliose consultants or admins who support off-ske users, this 
can provide an invaluable early warning of a drive failure. 



SMARTReporter Icon 

SMARTRcponcr's a snap to install, just drag and drop ii 
from the its disk image (.dmg) into your Applications or 
Util tries folder. When running, it can provide a SMAR'l' 
status indicator on your menu bar; 

elp 

SMARTReporter Status Irtdicalor 

SMARTReporter’s preferences allow an admin to change 
the interval of the check, define an icon set for the menu 
bar, set up email information, even launch another 
application if there's a hard disk failure, such as special 
AppleScript Applet to throw up an alert to the user or give 
instructions on w^hat to do. For email alerts, it can either use 
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the mail information speriHed, or h(>rrow Uie Apple Mail^app 
settings. If I had my druthers, Apple would include much the 
same funcikmality in future versions of Disk Utiliiy^ 

f> O S^AAftTRe po^Ier P references _^ 

1 Harddriws Appearance ^ Misc. 

Mark the drives to monitor 

Drive SLitt SUlus Interval 

TOSHIBA MKSOSe Dean 80 CB Venfied 120 


Mark all drives ym want to monitor for impending drive-failures wtttt 
the checkhoi^ef. Double d*ck rite current checking-interval of a drfve to 
enter a new one lin mlnute^l. 


Oo drive-failure do' 

^ Popup an afert 
CJ Execute application: 

?! Send an e-mail to: dean^macwo ties hops xom 

( Configure.T^ 


SMARTReporter Preferences 


Not So Smart 


SMART Reporting in OS X does have its limits, however. 
SCSI and FireWire disks aren’t supported, so if an admin is 
predisposed (like I am) use SCSI drives for inlemal RAID 
mirrors on servers other than Xserves, the diskutil command 
cannot get the SMART status of an SCSI disk; 

hoseZ:^ aostsdioin$ diskutil list 
/dev/dlskl 

^f; type name size 

0: AppiexpertlilQii„schejoe *17.0 GB 

t: ApplE_partitiQti_iDap 31.5 KB 

2: Apple_Driver_OpenFinnware 512.0 KB 

3: Appie_Boot_RAlD 17.0 GB 


identifier 
diskl 
disk!si 
diakisZ 
disk!33 


host2:"' moatadDiin$ sudo diflkutll Info diskl 
Device Node: /dev/diskl 

Device Identifier; disk! 

Hount Point? 

Volume Name? 


Partition Type; 
Bootable: 

Hedia Type: 
Protocol: 


Apple partition_.scheiiie 
Not bootable 
Generic 
SCSI 


Total Size: 17.0 GB 

Free Space: 0.0 B 


Read Only; 

Ejectable: 

OS 9 Drivers: 

Low Level Format: 


No 

No 

Yes 

Not Supported 


Note that the limilation for SMART reporting to ATA 
disks is something inherent in the way that OS X treats disks. 


FireWire disks, thougli, which always contain AlA or SATA 
drives nmning on Firewire bridge boards, don’t report 
SMART status to diskutil either. 1Tiis can be a major problem 
for Mac admios, who are increasingly relying on storage 
devices for second-tier file services or in some cases, low- 
cost backup devices. In the arena, all enclosures arc 
definilely not created equal, as shown by Granite Digitars 
Firevue’^" drive enclosures (Imp: //www.graniiedigitaLcora), 
which feature an LCD panel that displays the SMART status 
of the disk housed inside of it. I his gives their enclosures 
quite an advantage over others, considering that OS X 
doesn’t have the ability to get past the hridgeixiard lo read 
the SMART stams of the AlA drive inside. Look for other 
enclosure makers to ftjllow suit in ihe near future. 


Smart, And Its Mirror, Trams 

Ok, I’m not talking alxHit Disney World here, and the 
super long trains of trams that shuttle folks back and forth 
from the Magic Kingdom to the parking lots. I am talking 
about RAID Mirrors on OS X, however. One of the problems 
many admins have complained aboui with OS X and OS X 
server, is liie lack of noiiftcaiion thai a RAID Level I (mirror) 
is going to go south. The upside is thai if workstation or 
server in question does have a mirror, the other drive will 
continue to function until it\s replaced, and the mirror.s 
rebuilt. That’s why the word SMART i.s mirrored above (ha). 

Setting up a RAID Level 1 (minor set) is easy in OS X. 
After fjotjting off the installation CD tor OS X or OS X Server, 
drag the disks you want to mirror into the RAID window in 
Disk Utility and choose mirror, then create the mirror set. 
The result will be a RAID disk that appears as two stacked 
hard drives in drive and vi>)ume list on the left hand side. 


^ i 


Dili tiUliV 


at 




^ : r ' rj4ifli; 
3ib«j. 


nmjM ittP \ 


RAID Sdwffiflj Mtf riM 
muo Ham*: bwH 
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Mirror Raid Level I in Disk Utility 

Of course, diskutil is uviiilablc fur (hose who want to 
create, repair, check, or destroy a mirror .set from die 
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icnninaL For example, even though SMART status niighl not 
be available for SCSI disks, it’s easy to script notification for 
a SCSI mirror, and any RAID 1 mirror for that mntter, all 
based on output from diskutil. 

So what Fm looking for in the script below is simply an 
OK from both disks that are meml>ers or “slices" of the RAID 


hDSt2;^ inQstadmln$ diskutil checkRAlD disks 
HAID SETS 


Name: 

Unique IDr 
Type: 

Statusr 
Duvicu Kode: 


boat 

boutf 5 b 49 d 8247 UHd 9 ab 0 f> 0030 fi 5 ba 09 be 

Mirror 

Running 

disk 3 




Device Node 


Status 


0 diskl OK 

1 disk2 OK 


Mirror set, note how similar it is to the scripi that checks the 
SMARl* status of a single hard drive: 

#!/bin/sh 

*#This script is designed to get the status of a mirror set and send 
an email notice on fail 

## to test change the "good=2“ below to ’'good=l" and you should 

receive a warning email 

## Dean Shavit, MOST Training & Consulting 

dean0 macworkshop s .com ht tp ://www-macwQrkshop s .com 

##This is for servers lasing software RAID mirror sets on^^ 

## 

## Step 1: Define a variable for a functional raid by counting the 
number of good disks 

status=‘diskutil checkraid disk3|^rep c OK’ 

## Step 2: Define a number for comparison against a failed raid 

## Step 5 E Define the warning message for the body of the email 
WQrulng=’'hoU 0 ton we bave a problem!" 

## Step 4 E Define a variable for the computer name 
box-'/usr/sbin/scutil get ComputorNjiise' 

## Step 5 e Defiixe a variable - email address of person to notify 
adiniii“''dean#tQacworkshops, con" 

Step 6; compare current status with good status, if a match, echo, 
if not, noUfy 

if [ $Btatus = Sgood 1j then 
echo $status 

else echo From; $bQx Swarnlngl!I ) /tnip/houston.txt| mall - 
S "RAID Alert Report" $odinin v /tmp/bouston.txt 
fi 

done 


So, With both the SMART .script running as a cron job, 
along with the RAID scripi, it's easy to gel an advance 
warning of an impeding single disk failure, or when a RAID 
Level 1 has a drive fail or go out of sync. lt\s touglier with or 
SCSI drives, hiu if diL^yTc used in a RAID Level 1 
configuration, the script above can provide the same advance 
warning that tt can for SCSI disks under OS X or OS X Server. 


Maxwell Smart 

Recently, I was onsite for a couple of months helping a 
customef upgrade two hundred Macs to OS X. Many of the 
machines running OS 9 showed signs of hard drive failure, 
such as frequent l>oot failures, cornipt directories, slow lime 
to spin up and metallic whining .sounds. One day, a 
department manager’s hard drive failed, taking several years 
of email wiih it. We sent the drive into DriveSavers 
(hitp://www.drivesavers.com) for hardware data recovery, 
but no dice, the mechanism was too far gone, too much 
damage done to recover what was needed. It caused quite a 
stir in the IT department, and a discussion about early 
warning of hard drive failures. An interesting fact about this 
customer was that they had several UNIX/LJNUX experts on 
staff who were very interested in learning more about OS X, 
hut interestingly enough, tended to treat an OS X workstation 
as they would a Linux server They'd try this command or 
that command and comment that OS X was very different. I 
shared my SMART alert script with them, and they found 
SMARTReporter on Versiontracker However* they w^anted to 
be able to have a constant real-time log, on each Mac OS X 
box, t>f SMART .status and more sophisticated scripts that 
would report hack attribute information such as temperature 
or reallocated (bad) sectors. It wa.s time to go hunting for 
open-source tools. 

The first stop was at the Maxwell web site, 
lutp;//maxwelLsourceforge.net. Maxwell's a liny command¬ 
line program that (|ueries a hard drive for SMART information 
and can either report a pas.s/alx>ut to fail condition, just like 
Disk Utility, or a more comprehensive rcpcjit of SMART 
attributes. 1’he source code for Maxwell is less than 100k in 
si/e, and Ls such a simple program, compiling it doe.sn’i 
require configuration first. 


1. To install Maxwell, download the source code from 
SourceForge, then unpack the larball inici a folder on the 
Desktop. Open a ferminal window, then navigate to that 
folder: 

2. Lssue the following commands as in the example below^ 

[mlnitnc;'"/0Gsktop/inaxwell-0.5.1J dean^ Buda maki? install 
cc C O ran we] 1.0 maxwell.C 

cc 0 maxwell -framework lOKit -framework CoreFauodatloii 
maxwell.o 

/usr/bio/install d id 755 /usr/local/doc/maxwell 
/ust/bift/instail ra b44 LICENSE 
/uar/local/doc/iMxwel1/LICENSE 

/liar/hin/iostali -n 644 README /usr/local/doc/maxwe)1/README 

/uar/bin/install -4 -m 755 /usr/local/bin 

/uflr/bin/install -fi 755 maxwell /usr/local/bln/maxweII 

/ijsr/bin/install d m 755 /usr/local/raan/nanB 

/usr/bin/Install m 644 maxwell.S 

/usr/local/man/manB/maxwell.S 

[minime:-/Desktop/maxwel1- 0,5.1] dea n% 


Once installed Maxwell can l^e nm to get a simple pass/fail 
status by simply invoking it at the command line: 
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Device: TOSHIBA MK8026GAX 


With this much inrormaiiun m Imnd, it's quite a 
simple matter to Fifler this output so that, say, the 
Reallocated Sector Count test had a RAW value other than 
zero, then it could trigger an alejl email, or if the 
temperature reaches a certain level, or the spin retry 
count is greater ilian zero. The man page for Maxwell also 
suggests that it was designed precisely for scripling 
purposes and for integration with cron, Wfiile Maxwell is 
certainly a notch above the simplistic pass/fail test of 
diskulil, it isn't exactly the comprehensive, enierprise- 
wide type of solution that my customer was looking for, 
either. They wanted something tnore integrated into the 
operating system, a tool that would keep a log, and send 
that log back to a central syslog server, where trends in 
hard disk wear and tear could be monitored over a period 
of time. 


It*s A Smart World 

"‘It's a world of laughter, world of 
c heer, ids a world of hope, and a world 
of fear" Sound familiar? 1 can almost hear 
the little mechanical people singing! Our 
company currently keeps a few servers at 
Equinix, a state-of-the-art colocation 
facility near downtown Chicago. With 
giant steel doors, handprint readers, bag 
checks, and multiple security stations, it's 
not hard to imagine at limes youVe 
entering the back room of a Disney 
World exhibit filled with trade secrets. It's 
an interesting side note, that over the 
years, I’ve seen more and more Xserves 
and Xserve RAIDs populating the 
cabinets at Equinix. I’m sure many a 
pager would go off if one or more of 
lliose Xserve RAIDs had a drive failure, 
or if one of the internal disks inside an 
Xserve died, triggering an alert by the 
Server Monitor Application. 

But now' the Mac Mini, Apple’s (itllc 
darling unveiled at MacWorld, seems to 
have caught on as a tlie ‘‘server for the 
rc.sl of us." Tliere's even a hosting service 
for Mac Minis, called “Macminicoio," 
http://www.macminicolo,com, that allows 
Mac owners to “park*" their Minis in a 
cabinet for as little as $29.95 per month. 
While a colocated Xserve with a 
dedicated ItJ space in a rack at a facility 
goes for the street price of about $150 
per month, inckuiing one megabit of 
bandwidth {200 gb of transfer per 
month), there's aj>solutely no doubt that the proprietor of 
Macminicolo can certain cram a whole lot more Mac Minis 
into the .same cuiiic space an Xserve would occupy. 
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(minimer^J doati% isaxwell 

Device: TOSHIBA HK8026GAX Reported PASS status 

Or, for a more complete SMART report. It can be run with the -r switch: 

[iiiinliae dean% maxwell -r 
BSD Path:/dev/dIskO 
Serial: 54IK0355T 

Model: TOSHIBA MKe026GAX 
Firmware: PA002B 

Device supports S.M.A.R.T. operations 
SMART self-test supported 
SMART error logging supported 
S.M.A.R.T. operstions are enabled 
SMART self’test enabled 
SMART error logging enabled 
Off line collection status is 0 

Time to complete Off line Beta collection: 3 hours. 20 minutes 
Status Is GOOD 



TEST 

THRSH 

VALUE 

STATUS 

RAW 

{ 1} 

Raw Read Error Rate 

50 

IDO 

OxObOO 

0 

( 2) 

Throughput Performance 

50 

100 

0x0500 

0 

( 3) 

Spin Up Time 

1 

IDO 

0x2700 

1417 

{ 4) 

Start/Stop Count 

0 

100 

0x3200 

430 

« 5) 

Reallocated Sector Count 

50 

100 

0x3300 

0 

( 1 ) 

Seek Error Rate 

50 

IDO 

OxObOO 

0 

( 8) 

Seek Time Petfotmance 

50 

100 

0x0500 

0 

( 9) 

Power-On Hours Count ** 

0 

94 

0x3200 

2540 

( 10) 

Spin Retry Count 

30 

108 

0x3300 

0 

t 12) 

Device Power Cycle Count 

0 

100 

0x3200 

335 

H92) 

Power Off Retract Count 

0 

100 

0x3200 

2 

(193) 

Load/Unload Cycle Count 

0 

78 

0x3200 

228634 

(19A) 

Device Temperature 

0 

100 

0x2200 

223339413546 

(196) 

Reallocation Event Count 

0 

lOD 

0x3200 

0 

(197) 

Current Pending Sector Count 

0 

lOQ 

0x3200 

0 

098) 

Off-Line Scan Uncotreetable Sector 

Count 0 

100 

Dx3000 

0 

(199) 

Ultra DMA CRC Error Count 

0 

200 

0x3200 

0 

(220) 

Unknown 

0 

ICO 

0x0200 

IB4 

(222) 

Unknown 

0 

98 

0x3200 

977 

(223) 

Unknown 

0 

100 

0x3200 

0 

(224) 

Unknown 

0 

100 

0x2200 

0 

(226) 

Unknown 

0 

100 

0x2600 

241 

(240) 

Unknown 

1 

100 

0x0100 

0 


Device temperature is 30 degrees centigrade 


The names listed above may not actually be correct for each test value. The real 
values printed may make no sense whatever and the teapexatiire may be some crazy 
value. Different device manufacturers do things differently 


Reported PASS status 
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Rack of Xserves, Rack of Minis 


On a side mHe, the siRxess of (and need for) of such a 
colocation facility wliere “everyone am Imve their own server," 
shines a glaring spcKlight on one of die great weaknesses of Apple's 
OS X Server software: the lack of vimialization. In the Linux world 
(on IBM and Red Hat and Sliii solutioas), vinualbarion of admin 
tools and even die actual prex^essors ate a standard way of alfowtng 
companies to "reni" the resources of die sender, without having to 
actually "own tlie box" Whether it’s only lx*ing able to see your 
users when you log into a virtualized server or your file system, or 
on higher end solutions, your viraial server running on a Logical 
Partition of die server's resources (rPAR)^ OS X Server's Admin 
'fools liave al^soiutely no virtualization capabilities as of this 
writing. Tfs going to be quite a while l>efore OS X w^oukl allow me 
to log into an eight or sixteen prrxessor Xserve and administer my 
LPAK, wliich would api^ear u single* dual* or four prtxt^ssor server, 
wath my own environment, file system list of users and ,server 
daemons. T(xiay, Apple's solutions seem to focus on 
irdniaturization, noi virtualization. 

Asides from the obvious management dilenuiias that would 
face die sysadmins of MaeMinkxilo, where Mac Minis are 
smushed into a rack lliree across and three deep with their power 
.supplies and cxxiling fans. It seems tliat die system administmtors 
at Macminicolo have found a cool way to monitor their farm of 
Mac Minis: 


InsideOut monitoring was developed to monitor mac 
a Isicl based server from the inside out. A headless 
application that is placed in die startup folder of any 
OSX machine contacts a master logging server. We 
monitor factors such as network availabilify, Hard 
Drive space* network traffic moved, temperature and 
the iip/dowm status of specified applications. 
Cu^onicix sulisc^ribtng to tliis service can choose to receive 
email notification if limiLs or events trigger warnings. 

'Tliis sounds to me very much like the capabilities of the ojX'n- 
sotirce monitoring software Nagios (http://www.nagios,OTg), which can 


log all of the above events and present reixirts, graphs, and network 
maps in a web page. Aliliough temperature, application stats, 
network activity ^md free hard drive space are all gcxxl things to 
monitor, I wxiuld have co make tlie suggestion diat in a situation 
wxtli niulli[>le Mini Macs with laptop hard drives saiffed like muffins 
into a rack, SMART status should lx: tlie numlx-T one indicator 
monitored, becmise shcxild a hafo drive fail, theR''ll not only lx: an 
unha[ij)y ciisiomer who will have last all of their ckita if they don't 
have an offsite backup, but tlierell also Ixr an unhappy teclinickm 
scrambling to pull out a single Mini and replace the hard drive as 
quickly ;is possible. If a SMAR'l' monitor could give advance 
warning of a failure, tliat would make the whole prexess much 
trasier on everyone. 

So, in addition to an enterprise or medium-sized busine.ss 
needing to monitor die SMART sfaiii.s on lors of' hard drives in client 
workstations, it seems dial Macminicolo would lx- anoificr gtxxl 
example rif wiiere if would work quite well However* die .solutions 
I’ve kxiked at so far, like dLskutil and the script 1 wrote, 
SMAJfrRcfXJiter, and Maxwell, are ail missing an important 
aipability, none of them have the abiliry to write a log of SMART 
e\'ents eidier on die Icxid machine, or to a syslog server on the 
network, which of course, was tlic saiix* tiling my customer wanted 
for ilieir Macs. 

The Smart Test Of All 

Much of the really great open-S(.)urc:e software for OS X seems 
to originate fnim die Linux tiommunily* and such is the case with 
the smaitmontools, http://smartmontools.sourceforge.net, wdiitrh by all 
accounls Is the top tier srdiJtion for SMAR'f monitoring and logging 
in a non-Loiiaiicrdal distribution. Bmce Allen, mainrainer of the 
sniiiitmontooLs project, explains the origias of the package in an 
article that appeared in the Unux Journal: 

By profession I am a pliysicist. My resairdi grtiup mn.s a laige 
cT>mputing cluster with 300 nodes and 600 disk drives* on 
wliich more than SOTB of physk^s cLita are stored. 1 became 
interested in SMART several yaiis ago wficn I Realized ii ctxiki 
lielp reduce downtime and keep our cluster 0 [>erating mote 
rcJiably. For alxjui a yair I have fx^en maintaining an open- 
source package allied simrlmonUxils.., 

In July 2004, (^eoff Keating ported the smai1monttx>ls to OS 
X for ATA drive support only* (ihougli the Linux versitm includes 
supjxm for ATA/ATAPI-3 to -7 disks and SC^I disk and tape 
dcvkx.\s) l>ringing a sophistiatted and flexible SMART monitoring 
suite to OS X for die firsL time since Granite Digital discanrinued 
their commercial SMARTVue^ software nearly two years ago. 
Smartmoni<H>ls consists of two main components, a command, 
smarted* and a daemon* smartd. While smartctl functions like an 
improved version of Maxwx*ll widi various switches to control 
the verbosity and depth of the reports and self-tests, it's smartd 
drnt really lakes the monitoring to a real-time levei, where any 
changes in SMART status, rua jusi errors* are logged to a 
specified syslog facility. 

To install the smaitntontools from the source ccxle, make sure 
ytxj have tlie latest XctxJe UkiIs (Apple l^rveloper Ttxils) installed, 
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llien download die source tiidralJ from 
htlpV/smartrTK)ntoote.so^ and expand it lo a folder on ytiur 

Desktop, there’s many download packages available, but the one 
we’re looking for is c'alled: sniartrTionux)ls-532aar.gz. Open the 
'rermiruil navigate inside the folder and do the following: 

minime:“/desktop/eaartmoiitooIs 5*32 deanS ,/configure 

You'll see a long list of checking for (various components)* 
When the configure process is finished, type the following: 

tnlnlraei-^/Desktop/stBartmontools-S .32 dean$ sudo make Install 

After a page or two of build feedback, smart monttxils is now 
installed on your system* To start smartd, lyf^e the following 
command: 

niiiiiiiie:'-/deaii$ /usr/local/etc/rc,d/ijait*d/smartd start 

'lb run smartd automatically on startup, type the following: 

miniine:”-/deaii$ eado ditto /usr/local/etd/tc*d/init .d/ 

/Library/Startuplt ems/SMART/ 

Now yoy'll need to add a line to the end of y<iur 
/ctc/hostconfig file that reads: 

SMART:—YES ^ 

Tlmi will allow the SMAR'f Startupitem to rim every time your 
Mac Ixxits, and you1I also see the rea.ssuring message "Starting 
SMAK’i' disk monitoring'' as the daemon loads before the Uigin 
Window appears. Now that smiirtd is running as pan of the OS 
X sUirtup process, the next step's to configunr logging: 

minime;'^/deanS sudo touch /ver/log/smartd *log 

This creates an empty logflle to contain the smartd output, Tlie 
next step Is add the line Ixrlow to the /ctc/syslagd.conf file so 
that smartd knows where to write that output, in this case using 
the bee local3 log facility: 

local!,• /var/log/smartd,log 

t>r, if you’d like to send the log to a remote syslog server, 

then 

locals. * @in7.sysio&s€rver.doiiain 

and, if you’d like to make .sure that die smarttllog file is rotated 
weekly, mt)dify the /elc/peri<xJic/weekly/500.weekly file, so that the 
following l(X3p statanent fets stixutd*log in the list of nilated log files. 

for i in ftp,log lookupd*log Ipr.log iiail*lag oeLinfo.log 
hwmDnd.log ipfw.log aniartd. log; do 

Test it with: 

minimei/etc/periodic/weekly deaii$ atido SCO.veokly 

You should see the following line appear: 

Rotating log files: ftp.log lookupd.log lpr*3og irall.log 
netinfo^log ipfv*Iog smartd.log 

Lastly, you’ll need to nuxlify the /usr/kx'al/l^in/eic/sniartd.conf 
file to specify whicli drives you’d like to monitor, and which 
tests you'd like to am, as well as an admin nolification email 


addretss. Rcmcmlier, in OS X tJie startup disk is almost always 
diskO, if the computer has a single physical drive, when the 
/dev/lida placeholders in the smartd .conf file are meant for 
other UNIX systems, not OS X. 

First, open up the /usr/local/etc/smartd.cotif file in your 
favorite editor Luckily, tlie smiirtd*conf file lias an excellent 
synopsis of what each command and directive accomplishes, so 
it’s pretty self-explanatory: 

miniiae d&aii$ sudo pico /usr/local/etc/smartd.eonf 

Find the line that reads: 

DE¥ICESCAN 

And edit it so that it reads 

IfDEYICESCAlj 

This will telJ the configuration file to explicitly use the 
device you specify, rather than the one it finds on its own. 

Find the line that reads: 

#/dev/hda a -o oi'i -S on -s (S/, */,*/./t)2 |L/. /6/03) 

And edit it so that il reads 

/dev/dlakO a o on -S on -s (S/**/.*/*/02|L/.,/6/03) 

'fhis command will perform short and long self-tests and 
report full SMART status results to the smarid.log file on a 
schedule. 

Find the line that reads: 
tf/dev/hde -H -» ftdttln@exajiple,coiii 

Ami edit it so tliai it reads 
/dcv/dlakO H m deaneinacvorkshops.com 

'fhis fe.st will notify you by email if the simple health check 
(pass/about to fail) shows that the disk is in trouble. Now, 
restart the .smand process with the following command so 
that smand will re-read its configuration fife: 

iaitiiiiii^:~/deDn$ jsudo killall -HUP sin^rtd 

Now the smartd.log is visible in the Console application 
located in the /Applications/utilities folder, and we can read 
the events we just kicked off Now your Mac has a real-time 
log of SMART events and a notification that is emailed 
immediately when the failure occurs, rather than waiting for 
cron to do its thing. 

With log analysis tools such as Oak 
(http://www.ktools.org/oak.html), smand logs can be analyzed 
to project trends of failure thai might occur in waves, due to 
defective hard drives. Remember the Quantum Bigfoot 5 _ 
inch hard drives from the late 90s? I’hey never were sliipped 
in a Mac, but at the time Compaq put them in tens of 
thousands of their Deskpro workstations, and nearly every 
single disk drive had to l>e replaced. A tool like smartd can 
help prepare companies for a run of defective hard drives 
that might die, en masse. Other features of smand include 
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a daEabase of hard drive SMART aiiribine.s (not nearly 
cotnplele, but you can submit a device report from your hard 
drive for suljmission to the database by using smartctl -a to 
and emailing it). The odter ""halP' of the smarrmon tools is 
the smarutl command, which can be queried through cron 
scripts or directly from the command line, much like MaxwelL 
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later Or even, “II seems like those Hitachi hard drives are 
dropping sectors like crazy, maybe we'd better turn up the 
air conditioners.” So, for those wlio’d like to get started 
quiekly with the smartmonrools, I've whipped up a Installer 
package that puts the smartmontools on your Mac, as well as 
the requisite Staitupitem. Mowever, you'd still need to 
configure the /etc/hostconfig, /etc/syslog.conf, 
/usr/local/etc/smarid.conf files and create a smartddog file 
yourself. The insialler is available along with the scripts in 
dvis article at http://www.themachelpdeskx'om. Now, Td like 
everybody to join me “. . . There^s so much that we share, 
that it's time we're aware, it's a SMART world after alL . 

In Next Month’s “Source Hound” 

Steve Jobs, in his keynote address at MacWorld, 
repeated the following mantra over and over ‘'H,264, H.264, 
11264." Sure, H.264 supporl is with QuickTime 7, but if you 
want it now, it's available texJay, not from Apple, but from 
the deepest trenche.s of the open-source world, the realm of 
the Conehcads and the video rogues, where encoders are 
eneexiers and QuickTime is QuickTime, and never the twain 
shall meet, or will they? 

'/ill 


Everybody Now . . . 

1 realize that downloading, compiling, and configuring 
the smartmontools isn't for everyone, hut if certainly is a 
rewarding k^urney for those administrators who warn piece 
of mind and a logfile, at least until the stonn hits, , J>ut even 
for consultants who sup[)ort liomc users the smartmontools 
or even a simple script or SMAR'l’^eporter can be a real-life 
saver. Wouldn't it be nice to call a customer and say, “Hey, 
I'm going to come over with a brand-new hard disk, backup 
your data, and replace your drive, because it's going lo fail . 
. Or better yet, “Backup your data, now, before it’s too 
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Near-Time’s Flow" 


Peer-to-peer content and knowledge 

MANAGEMENT FOR PANTHER 


What do you get when you cross iCIiat, Safari, an RSS 
news reader, Microsoft Word, Adobe GoLive, and a handful 
of other popular productivity tools? You get Near-Time 
Flow™; an extremely fascinating and powerful 
conteni/knowledge management, collaborative workflow 
solution for Panther 

Released this past 
June post-WWDC, Flow is 
virtually impossible to 
categorize as a single 
piece of software. Alter 
spending some quality 
time with it, though, you 
come to understand that it 
is part WYSIWYG web 
editor, RSS aggregator, 
word processor, outline 
tool, email client, and then 
some. 'fliis unique, 
hypertext-based software 
is targeted to both 
individuals and work 
groups of any size. It's an 
authoring tool, a gathering 
cool, an organizational 
tool, a colbboraiion tool*, 
it should have a big red vS emblazoned on its box! 

Creating, gathering, and organizing 

Life within Flow happens in two windows 
simultaneously, metaphorically dubbed Flow Space and 


Folio. From within your Flow Space you can create multiple 
Folios specific to your projects tliat can be shared or kept 
private. Once you’ve created a Folio, you can add any type 
of fiie by dragging it into the Pages pane of the Folio 
window where everything appears in an orderly list that can 

be arranged to suit your 
needs. Add RSS feeds, web 
pages, images, and other 
documents and enjoy the 
hli.s.s of managing, viewing, 
and commenting on them 
all in one convenient place, 
within a single interface. It 
even dutifully alerts you 
when an updated RSS feed 
is availalile by placing a 
blue dot beside it. To gain 
an appreciation of how 
easy and powerful the Folio 
metaphor is, visit Near- 
Time’s web site and watch 
the QuickTime movies 
illustrating several of Flow’s 
key features. 

You can also create 
new content in either text 
or HTML format, yielding a native Flow document. I found 
the Ruler option to be quite handy in this process, though 
text formatting is handled via a drop-down window similar 
to—and as inconvenient as—that found in KeyniRe. You can 
link content pages together by simply dragging them from 
the Pages list to the Content area of another. Add web pages 



Figure K Your Flow Space lists Folios, Shared Spaces, other Flow 
users within those spaces, and available servers. 
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und RSS feeds by dragging the URL straight into your Folio 
from a Itrowser's adtlress bar. 



Figure 2 . From within a Folio you can view content assets 
such as live URLs and more. 

Sharing and publishing 

Not oaly dt>c.s Flow jjIIow you to gather and t)rgaai7:e 
all of your project documeriLs, it gives you the ability to 
share and publish them out to others as well; Flow users 
or not. These options include: 

• sharing Folios through Rendezvous or other 
internal network 

• sharing Folios through Real-Time's server with 
other Flow users (availal)lc for free for one 
month after purchase, then $29.93 per year 
thereafter) 

• publishing Folios in web site form to an iDisk or 
Ollier server 

Once a Folio is shared, all hies—even those of 
external origin—are translerred [>at:k and forth between 
the Flow users with In a Shared Space. The touch of a 
button activates a manual sync, though Flow checks 
periodically and notifies you of any content updates with 
the aforementioned appearance of blue dots. 
Unfortunately, a major flaw showed up during testing 
when Flow' became confused as lo who had edited the 
last version of an Excel spreadsheet, and caused both my 
colleague and I to lose changes the other liud made. 
Similar losses occurred with comments made on an 


Adobe InDcsign file. The sharing proce,S5 worked 
flawlessly with native Flow documents, RSS feeds, and 
web pages. 

Flow supports version tracking on all content lhR>iigh 
a convenient date/time stamp bar at the bottom of each 
Folio document. Not only can you see when a document 
was edited, marked, or commented upon, l>ul you can 
also see who made the change. I was impressed to find 
that Flow also accounts for differences in time zones 
Ixflween users in a Shared Space while testing its 
collaboration features with my colleague on the East 
coast. I’he Folio workspace itself would benefit from 
more standard controls for text editing (bold, italic, etc,) 
instead of the drop^dowm menu, as well as some visual 
cue as to what mode one is in, especially when invoking 
changes. 1 kept forgetting to click the Make Changes 
buttem at the bottom of my Folio window while trying to 
add comments to a document. 

The publishing aspect of Flow is effective, allowing 
the creaiifm of visually pleasing project web sites with a 
single button-press, enabling the sharing of Folios 
between those who use Flow and those who do not. We 
experienced a few problems when publishing a Folio to 
an iDisk: native Flow documents, linked URLs and RSS 
feeds uploaded llawicssly; however, attached files (Excel 
.spreadsheets, InDesign docunient.s, etc.) were included 
only pari of the time^—sometimes they would be uploaded 
to the server and sometimes not. To Flow's credit, it gleans 
iDisk data from your System Preferences; however, you 
must manually enter your iDisk password. Flow failed to 
snag it on lK>th my and my review partner's system. 

Smart Folios, blogging, and 
searching 

Another impressive Flow feature is the Smart Polio 
option. By creating rules you can automatically and 
dynamically aggregate information from various sources. 
The concept is similar to Smart Playlists in ITunes and is at 
least as useful, especially as a projea expands Ixah in size, 
and nunilx:r of team members involved. 

If you are interested in the ever-expantling world of 
l)logging, you will find Flow's options to create ctmteni and 
publish to Moveable Type, TypeFad, Wordpress, or Blogger 
extremely useful. Simple, one-button tiploacLs to your blog 
may be a compelling reason to give Flow a try. 

Flow’s .sophLsticiuxl Search fcaliire pcrfbnTK’d flawlessly. The best 
way to appreciate it Is to open an existing Flow document (c.g. the 
iiicludcti User’s Gukle), and then queiy it using a search fxinel that 
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kxjks j5aspic:ioii,sly like the one in Panther's I’intler. It then aeates a 
brand new page with all the results listed, highlightiiig tlie search terms 
as hyperlinks back to die ii[>f>ro]iriate section of the cl<x\imemiitk}n. 
One can easily imagine how publishing this page lu tMher Flow users 
would facilitate work on specific asfxicts of any profect 

Final word 

As a single, individuat project management and 
authoring tool, Flow largely lives up to its claims. You can 
easily and effectively collect and manage the as.seLs of a 
particular project within the Flow Space and Folio 
metaphors. As long as you're working with assets that Flow 
understands and can edit, it is also an effective 
ccjllaborative tool, making the sharing of project documents 
between development teams and departments much easier 
than via email. 

Flow's krypLonite, if you will, seems to Ixi only when 
you mix in files that the program d(x:s not understand and 
must handle as attachmenCv—thafs where it beaime less 


reliable. 'Ihe progmm is priced to be. ticcembiii to anyone 
who has serit)us collalxirative needs, and is poweriul enough 
k) l>e at the top of the line of a new category of productivity 
.software, once a few of ilic inconsistencies are worked out. 
*l'o get a Full appreciation for wfuit Flow i'zn do, you will need 
to climb a significant learning curve, though the trip is worth 
it to access the software's power for your projects. 

You can try it for 30 days for free by downloading the 
trial version from the company's web site at http://www,near- 
time.com> 'Hie cost for a single seat is $99*90, and a ten user 
license is $859.95, a respectable value to be certain. 
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MAKme SENSE or 30 4 I.IS S 


By Josh Wisenbaker 


What’s this all about? 

One of the most essential, and misunderstood, UNIX 
admin skills is l:>eing able to effectively use llie cron 
daemon by maintaining your c:n>nlab files. Tlie big 
problem is that the formal of the crontab files can be very 
hard to gmsp at first. Full of bizarre looking statements 
such as “30 4 1,15 5”, the crontab scheduling statements 
can put off many users Ixrfore tliey begin. By the end of 
this article it is my hoj^e that you will not only have a firm 
grasp of the crontab format but also have some gtKxl 
ideas of what you can do with cron. 

Cron 

O.K, here we go. Cron is tlie name of the program 
that ruas scheduled tasks on your Mac. For example y()u 
can use cron to call a command to upload files to a web 
server, fetciimaif fn>m a remote server, roll and archive 
log files, or clear cache files. In general, any non¬ 
interactive task can 1^ easily automated with cron. 

Like most things on Mac OS X, cron is almost, but not 
quite, like cron on other UNIX systems, The main 
difference is that it is started by the 
/System/Library/Startupltems/Cron startup item rather 
than the /etc/rc f)(x>t script. Other than that, you can treat 
cron on Mac OS X the same as you would on any other 
FreeBSD or Linux type system. 


When cron runs a command or script it can output 
llie results to a log, e-mail them to a user, or just discard 
them and not l^tther you with the details. 

it does ail this by reading a file, called a crontab, once 
a minute to see what needs to be run and when. Tliere 
can be several crontab files on the system. By default 
there is only the system crontab located at /etc/crontab. 
This file contains things like when periodic should run to 
perfonn the daily, weekly, and monthly scripts. Each user 
on the system c:an also liave a crontab file so that non¬ 
admin users may schedule tasks as well and these are 
stored in /var/cron/tabs/<u.sername>. It should be noted 
however that the format of the system crontab is slightly 
different than Lhai of the user crontabs and the methods 
used to edit them are very different, 

Crontab Demystified 

The Basics 

Before we lake a kK>k at how to edit the crontab files 
let's lake a moment to get the basic formaning figured 
out. That way when you open /etc/crontah for die first 
time it will make sense to you. Although it seems mystical 
at first, the format for a crontab is actually very simple. It 
breaks down like this: 
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minute hour day-of-the-month month day-of-the-week 
command 

The values are separated by white ^space and the final 
value, command, may contain spaces of ifs own. Let’s ltx>k 
al the five values that make up die time to mo section,,. 

For the any of the settings you can use nuniliers 
starting at 0 and you can optionally use names for the 
momli and day-of-the-week settings tlianks to Mac OS X*s 
FreeBSD roots. (Really this is due to the fact tliat FreeBSD 
uses an enhanced version of cron, written by Paul Vixie,) 
When using the names of months or days just u.se the first 
tliree letters in a case-insensitive fashion. A is a 
wildcard that means firsi^lasL and matches anything. So 
let’s say we want to schedule a task to run on the hour, 
every hour. 

0 * • * * command 

Hull? How does that work? Easy. The 0 minute Ls tlie top 
of the hour. Ihe wildcards match all odier possibilities. So 
it breaks down to minute 0 of every hour, of every day, 
of every montli, every day of the week, kxjk at 
another one. Let's say yf;)ij want to run something every 
Sunday at 12:15 am. 

15 0 * * Mun cotimiand 

So you are telling it run on minute 15, of the 0 hour 
(midnight), every day of the month, every monlh, on 
Sunday. Notice here that you tran use *sun' for Sunday. 
You could alst) use 0 or 7 for Sunday if so inclined. Let's 
take a ItKjk at one more basic example. Pretentl we want 
to run a task at the beginning of each New Year 

1011* command 

Cron will interpret this as January 1 at 12:01 am every 
yean Just liec:ause it is a repeating task it doesn't mean 
that it needs to rejKjal very often. If you want to start 
spacing your jobs out in intervals larger than a year 
though you will need to take care of tliai in the command 
or script that you call from cron. 

Step Values, Ranges, and Multiples 

If we were restricted to simple schedules like the ones 
just given, cron would not be very flexible. Luckily we can 
get a bit more creative with our crontab entries. Say that 
you’ve decided that you need a task to run at 12:15 am on 
both Sunday and 'Riesday nigliLs. You could make 
multiple crontab entries or use a value list. 

15 0 * * 0*2 conmand 

Will accomplish our desired .scheduling witli only one 
entry* Notice here diat we used die numerical values for 


the tbiys although ^sunttue” would work as well, A 
second option at our disposal Is the step value. 

If you wanted something to run every two hours you 
could specify “0,2,4,6,8,10,12,14,16,18,20,22" for the 
.second field but that is really messy* Luckily we can use 
a step value to make this easier and arrive at the same 
result with So let's .say you want to make sometlung 
that nins every other month on Sundays at 4:32 am.,* 

12 4 * */2 sun command 

You can also use a range in place of a list. Rather than 
type “ 9 , 10 . 11 ,I2,13.14.1‘3.16’’, just luse “ 9 - 16 ”. 

0 9 16 * * ’ coiEMsnd 

This will run our command every day» on the lK>ur, from 
9:00 am to 5:00 pm. Since Mat: OS X is a FreeBSD based 
system we can combine ranges, lists, and step values in a 
single cronlitb entiy. Building on the last example: 

0 0 3,9 16/2 * * * command 

Will run our command every day, on the hour, from 12:(>0 
am to 3:(KJ am and again every other hour from 9:00 am 
to 5:00 pm. Systems that do not use the Vixie cron w^ould 
choke on this. 

More BSD Family Perks 

Since Mac OS X is FreeBSD based we can use some 
handy shortcuts. Rememlxrr our first example, *o * * * *' 
that ran a task every hour? Well, you could also just say 

^hourly camniand 

l.sn't that nice? You can also use ©relxKit (Once on 
sUrtuf)), ©yearly (0011 *), ©annually (same a,s ©yearly), 
©monilily (,0 0 ] * *), ©weekly (0 0 * * 0), ©daily (0 0 * * 
*), and ©midnight (Same as ©daily). 

Anotlier set of options is available to us as well in the 
fonn of environment variables. You can use the SHELL 
variable to override tlie defauii setting of /bin/sh* Usage 
is simple: 

SllELL=/bln/bash 

Just place tills, or any of the following variables, at die 
l^eginning of your crontab. While the SHELL variable is a 
hit obscure to many administrators, the FAITI, MAJLTO, 
and HOME are a bit more familiar. By default cron will 
just use the padi defined for the owner of the crontab but 
you can use the PATH variable to override it... 

PATH=/etc:/bin:/shin:/usr/bln:/usr/sbln 

You can use the HOME variable in a similar fasliion. 
HOME-/var/log 
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By far tlie most useful environment variable we can 
define is MA1L1D and it has a few usages. By default cron 
will e-mail the output and results of commands to the 
owner of die crontal> file. We can modify this I>ehavior in 
two different ways: 

MAlLTO^-’jOEh" 

will redirect all mail for the crontali lo the user named 
“josh" and 

HAILTO'"* 

will suppress any mail from the crontab at alL You may 
find this option useful for a crontab file whose commands 
that are logged, hut do not need to be mailed to anyone. 

Command time 

OK, now that we know how to schedule something 
what can we do? Well, anydiing you want! You can run 
single cominands or scripts and widi advanced Mac OS X 
features like osasc:ript you can even run AppleScripts to 
drive things like Photoslic^p. Tlicre are only a few things 
to keep in mind when typing your ct>mmands with the 
main one being that It must be all on one line. If you need 
to use a newline for y<)ur command you can eml:)ed a “%" 
to indicate this. Take a Ux?k at the following example. 

0 0 2 2 * mail -s “B Day!" JofllltHeyl^Happy birthday JoshU 

Ibis will produce an e-mail with the appropriate newline 
returns in It. If yot* want to actually use die chanicter in 
your command you will need to escijye it widi a backslash. 

You can also siring uigedier multiple commands with 
pipes and semicolons just as you would in the Terminal. If 
you wanted to get a daily update from die login acamniing 
systems (Don’t confuse simple commands like ac and kest 
with the recently released SiMaris BSM auditing tools fmm 
A[iple.) via e-mail you could use the following entry. 

0 10 * * * (ac ‘p: echo: last | tail) | niail -s “Login 
Accounting^ admfri@foo.com 

Notice dial the pipes work just like you would expect 
them to anti the parenthesis are used lo group the output 
of multiple commands into one resull. It's also worth 
noting dial die output of the ac and last commands will 
be sent to admin@foo.com hut the report that the command 
was run will l>e sent to whoever owns die crontab or a 
user S|>ecified with the MAI LTD variable. 

So far all of diese examples are fairly trivial one-line 
c'ommancls, but diat doesn't mean one-liners can't l>e 
powerful. If you support designers using Adolx: lllusirator 
then you have run into Adobe font cache issues. WouldiVt 
it be nice if those nasty things ju.st magically disappeared 
each night^ 

15 0 * ‘ * find -X / ’type f -najne ■ AdoheFrit*, 1st ‘ exec rm 
f fl\: 


If you add this to rooTs crontab tir the system crontab 
then the stupid Adobe font caches vanish every night 
al 12:15 am. 

You can only stretch one command so far though, so 
you will find times when you need to resort lo calling a 
shell script with cron. Here is a simple script 1 use to 
liackup my liome folder if a parriailar FireWire drive is 
connected using psync. 

#l/bWbaeh 

If r 'd /Voliiiqes/TInyOrJve/Backup J 
then 

/uer/local/bin/psytic -d yUsers/josh\ 

/Volumes/TinyDrive/Backup/josh 

exit 0 

else 

exit 0 

fi 

I just call diis once an hour with cron and my home folder 
stays backed up safe and sound. 

Extra comniand tidbits 

As I mentioned earlier, c:ron st?ncis an e-mail to the 
owner of the cron with the results of each job that runs. 
But what if you don't want any output from a particular 
command? The easiesi way to snuff the results of one 
command is just to send tlie ouipul lo /dev/niilL When I 
run my backup shell script 1 send lx:tth stdout and stderr 
u> ihe hit biirkel... 

@bcjurly /backup.sh 2>&1 /dev/null 

Tills way tt never hugs me with the results. If I were just 
to send sidoui to /dev/null then il would just send me the 
errors. Redirecting the out[)ut of a specific cc)mmand is 
much more selective than using a MAILTO="’’, as dial 
t>ption will kill all ouiput from the crontab. 

^fhere is one more, reiilly txxil, Apple added feature, 
l^ei’s say that 1 have a sync operation that runs every 15 
iiiinuies. Now if il Ls critical data 1 probably don’t want tliis 
to run if tlie power Is t>ut and the system is on the UPS. Tf 
you prefix a command with ©AppleNotOnBattery' Uien 
crt)n will noi execute the command if not on AC power. 

§AppleNotOnBattery command 

is all you need. 

Editing your crontab files 

Tliere are two distinctly different types of crontab files 
on Mac OS X, die system crontab and user cnxinlab files. 
Tliey have slightly diflerent fomiatting, but are edited in very 
different ways, let's take a lcx>k at the system crontal^ first. 

The system crontab 

Located at /etc/crontab, the system crontab is 
typically used for system maintenance activities sut:h as 
the periodic command. One of the nice things about the 
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system crontab is that tl is coniinented and the first thing 
you should notice is tJial it has an extra field in the eniry 
lines with a ‘'who” variable between the weekday and 
command. Since any particular user does not own this 
crontal^ you must specify wlioni the command will have 
as its owi\er. Take a look at this example. 

tS 1 * * “ root p&riodic dally 

15 0 * ' * ttiiillinan /usr/share/malltaan/blti/check_perti?J 

Tlie Rrst command is the daily nin of the jKTiodic 
command that all Mac OS X ctjinputers come Notice 
it runs as rcK^i. The second comniand checks the 
permissk>ns on die mailman install of a Mac OS X Server. 
Notice it runs as the mailman user. For security reasons 
you should keep the amount of tasks j^erformed as roor to 
a rninimum. In tliis case the mailman user has the rights it 
needs to get tlie job done, and it owns the files in ciuesdon, 
so it makes sense to run this command with that user. 

To edil die system crontab you simply open it widi 
your editor of choice. Beware of line wraps though when 
using tools such as picn. (Since pico is such a popular 
editor 1 will pcnnl out that running it with a -w fiag will 
minimi/x' line wraps.) Rememlxfr that this file is owned by 
root, so you will need to u.se siido to C'dii it. Simple eh? 

User crontab files 

One of the nice filings alxiui cron is that any user on 
a syslem may use it. However, it should be obvious that 
you don't want regular users messing alxjuL in file system 
crontab. Luckily there is a system [>rovided to get around 
this i.ssue and c'ach user may have an individual crontab 
file. The individual user crontab files are kept in 
/var/cron/tabs/<usernarnc> and, unlike the system 
crontab, they may not l>e edited directly. Instead you must 
use file crontab command. 

The crontab command has a few basic usages. To edit 
your personal crontab simply use: 

crontab -e 

and your crontab file will t>pen up for editing. When it 
opeas the crontab it does so using the defauli editor, 
which unless you have changed it, is vim. (Now some of 
you will yell at me for it, but vt is a six headed l:>east to 
me and I cliangcd my default editor to pico by adding 
“export EDITOR=pico” to my .prcifile. The only real 
requirement of the editor is that it can edil the file in place 
without unlinking it.) Once the file opens up, just create 
your entries and save them, Thai's it! Cron will evaluate all 
the crontab files on the next minute and execute anything 
that il finds. No HUPing needed. 

You can also use the crontab command lo list your 
existing entries with a —1 Hag or remove your crontab with 
a -r flag. If you chtK)se to use the remove flag the system 
will prompt you for approval tefore deleting the file. 


If you have administnUor rights you can edit the 
crontab files of other users as well. If you rememlTer our 
imilman ex;imple from before, we could just make that 
entry directly in the mailman user's cronlal) file by using 
I he —u flag. 

Budo crorUab -u raailmaa -e 

Now mailman's crontal> will open and you can add jobs 
to it as you see fit. Note that if you simply used "sudo 
crontab -e” that it would open R>ot’s crontab file. This 
can get confusing though and 1 would recommend that 
you always .specify the user when editing a crontab file 
other than your own. 

Security issues 

Now that you know thai any user can create and use 
a crontali file your admin senses should l>e tingling, 
alerting you to the clanger c^f unrestricted cron jobs. Out 
of the box there is nothing .stopping a user From leaving 
a time bomb of a command in their crontali file. You 
might not even reiilize it is there until it unleashes its 
havoc^ at .some later date. Imagine having 5(X)0 users in 
your sysiem that have shell access, but you only need 
r<K)t, bugzilla, and mailman to have access to cron. What 
can you do? The solution is simple as cron, like many 
other daemons, has a facilily for allow and deny files. 

Located at /var/crnn/allow and /var/cron/deny, these 
files provide a simple way to restrict crontab usage. If the 
allow file exists, users must be listed in the file in order 
to use c rontab. If your system has a deny file hut no 
allr)w file, then users must not be listed in the deny file 
in order to use crontab. By default, neither of these files 
exists. On a basic: Mac OS X sysEeiii this allows unfettered 
acrcess lo the crontab command. 

By using an allow file without a deny file you can 
easily restrict crontab lo just a lew users, thus making 
your Mac OS X system mucli more secure. 

Wrapping up 

So that's it! Anned with your newfound cron and 
crontab skills you can tegiii to automiite all .sorLs of tasks on 
your Mac OS X systems. Backups, file iirchiving, software 
upekites, and trash patrol can all be automated. ’Ihe more 
you I lave tlie system work for you, the les.s work you need 
to do for it and isn't that the goal of every sysadmia^ 

Yill 
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PATCH PANEL • by John C. Welch 


Movable Type on Panther 

No Need To Wait For Tiger To Get A Topnotch 
Blogging System On Mac OS X Server 


Welcome 

Now, while Tiger Server will give you 
blog as part of the standard installalion, 
there are a number of reasons not to wait 
for that For one, while I'm ciuUe sure that 
Applets blog setup will be functional and 
work well for most; it may not 1^ a system 
that d<x;s everything you need it to do. 
(Hverything I’ve read indicates tliat Tiger’s 
blog setup will lx* based on Blojsom, a Java 
blog implenientiiiion.) 

Secondly, if you are going to use a 
blog as a produaion system, you’ll want to 
Lest I'iger server out thoroughly tefore 
unleashing it on your users. Finally, why 
wait? 'Ihere are l>log systetns ilmt you can 
run on Mac OS X Server ttxlay, and we’ll 
take a look at installing and configuring 
one of them, mimely Movable Ty[X^, fre^m 
Six Apart, <http://www.si)tapart.corri/), aeators 
of Movable Type, the TypePad blogging 
service, and new owners of Uvtjournal, a 
public blogging community based on Open 
Source software. 

Why Movable Type? 

Well, fur a numIxT of njasrjns. One, I'm 
familiar with it, as my own weKsitc, 
(http://www.bynkiLcom/) is a Movable I'ype, 
(Movable Tytx) Ixised site. (No, f’m not an 
H1ML whi?^ which is one reason wliy I like 
blogs.) It's quite popular in the Mac world, 
witli sites ,sudi as NSLog(.);, and Daring 
Fireball atixDng tlie sites using Moval>le Type. 
It can run easily on Mac OS X Server, ona? 
you gel k)w tti install it, and it can use various 
datalxises as a back end, such as BerkeleyDR, 
MySQL, PostgieSQL, and SQUte. 


Movable Type uses CSS and other standard web 
technologies to create its “look" .so if you don't like any of the 
defaults, you can change it to suit your needs without having to 
worry aixjut what it will do to various bR)wst‘rs, and almost any 
web design tool can l:>e used with Movable Type. 

Movable Type Is well d<K umenied, and has a solki API that 
can be used to extend its leatureset a numlxr of ways, including 
plugins. Jliis is not to say that the other systems aren’t just as 
good, but 1 had to pick one, and I know Movable Type, so, this 
is the one we look at. 

Getting Movable Type 

Getting Movable Type can be a little tcdkms, hut there 
are a number of license configurations that will work for 
anyone, from free, to not ridiculously expensive, depending 
on the numl'>er of blogs and authors you want. Note tlial 
with Movable Type, if you have separate blogs that all fall 
under the same root domain, (such as those I use for the 
various sections of Bynkii.com), thafs considered a single 
blog as far as itcensing is concerned. Go to 
http://www.sixapart.com/movabletype/pricing, and pick the 
configuration that works best for yoiu 

Once youVe selected your licensing configuration, 
download tlie full install of the late.st version of Movable Type, 
3T5 as of this article. (You’ll liave to gel a free TypePad ID to 
gel Movable I'ype, but in my experience, Six Apart has yet to 
.spam me, or email me at all for that matter, and I’ve been using 
Movai>fe Tyi>e for a little over two years now.) You select the 
formal you want, Tar.gz or .zip, and download it to your Mac, 
either the server yoifll be running it on, or an administration 
station. Expand tlie archive, and then immediately navigate into 
the docs subdireaory, and open miinstiill.fuiTil in a browser. 
This contains the primary installation dcxuinentation, and you 
will want to lx* c|uite familiar with it. Almost every problem Eve 
ever had with a Movable Type insuillaiion on Mac OS X Server 
is either due to not paying attention to tlie direciitjns, or Apple’s 
changes to a standard Apache install 
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W itli all the hoopla about Mac OS X Server 10.4, and all the new 
tricks it’s going to bring as part of the standard installation, I 
thought I’d take a look at one that’s near and dear to my heart, 
and see about implementing something similar on the current version of 
Mac OS X Server, namely the Weblog, or “blog” implementation. 


Installing Movable Type 


Okay, m weVe reacJ the instruclions, and we're going to set 
up Mtjvafjlc* Type on our Mac OS X bcjx. To keep things simple 
for tills article, we're going to use the fferkelyDB as liic hack end. 
IhLs is where things get a lillle odd thanks to Apple's...unique 
take on Apache directory setups. I'irst, you want to ensure tliai 
Perl b in the right pbce, since Movable Type makes heavy use 
of Perl. Open a command line 
window in tenninal and run 
"wh i ch pe r I'" The aaswer 

should he /usr/bin/perl, as 
ihaTs tlie normal place that Mac 
OH X [Juts it. If you've modified 
your perl location, follow the 
Movable Type inslnjctioas on 
changing llie CGI files so they 
know where to look. 

We're going to install die 
Movalile Tyt>e CGI files into 
Apple's cgi-hin direaory, so we'll 
want to <Teate an mt-siatic 
directory in the main web 
documents direaory. For our 
example, we’ll use 

/Libra ryAS^ehServcr/Documents/. 

You can have this directory 
anywhere along with your aaiml 
non - CGI Hies, but again, we're keeping it simple. We're going to 
pul all the CGI filers into the default CGI location, 
/Libniry/'WebServer/CGI-Hxetnitables/. 

However, l>efore wc do ^iny of this, we want to make sure that 
die Web services for tliis site in Mac OS X Server are nSei ct>rrecLly. 
Start up Server Admin, and select the Web sctdngs. Gti to the lower 
Settings tab in Web services, and select the sites tab. Open up the 
site you're going to use for your Movable Type in.sTaJlation, and 
under options, enable “CGI Kxeciiiion'* and disable “Perfomiance 
Cache^ Yoiill also want to go into die Modules tab and make sure 
that die perl_intxlule and plip_nKKJules are enabletl, since Movable 
Type uses iKilh. Save those changes, and exit Server Admin. 


in lemiinal, (you can du all of tliis in the Finder, or even via 
SFFP, hut in the end, tenninal ends up being a more dirc'ct and 
simpler way to set up Movable TyjxrJ, cd to /library/Dtxtimenis/ 
and c’reate a directory mimed ml-skitic. Set die permissions sti 
owner and group luive full pemiissions, everyone else has read 
and exeaite only, i.e. chmod 77 S mt-static. Tlicn copy the 

following items into this fokler, as 
per the Movable Type instaliation 
inslRiclions, {wliicli, since you lead 
them diorougWy Ix^fore starting, 
you already know to do this.) 

•Tile ini.is file 
•The scyles.css file 
• The dtKs folder 
•The images folder 

Once those are in mi-slatic, 1 
SCI the permissions for them as 
follows, (Note: This is for a 
server that only talks lo internal 
clients. If this server will be 
exposed to the public Internet, 
you will want to .set your 
permissions more restrictively): 

mt.js 10 full pemiissioas for owner and group, read and 
execute only for all others Cchtnod 77 S) 
styles.css to read ^ write for owner and group, read only for 
all odiers Cchinod 664) 

The coments of the docs folder to read Sl write for owner 
and group, read only for all odiers (chaiod 664) 

The d(K:s folder itself to full permissions for the owner and 
group, read and execute only for all others (chmod 775) 
The contents of the images folder to read Ik write for owner 
and group, rc^ad tmly for all otliers (chmod 664) 

The images folder itself to full pennbsions for the owner and 
group, read and execute only for all odiers (chmod 775) 
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Finally, sei the owmr and grnup for mt-.static and all its 
contents to wu'w, the web server user used by Mac OS K’s wcl> 
services, (chown -R www:www mt-static/) Now that we 
have mt”Stattc taken c'ate of, let’s go set up the meat of Movable 
'iVpe, the cgi directory* 

Change directory to /Ltbrary/WebServer/CGl-Executabie,s, 
the default CGI directory for Mac OS X Server* Create a directory 
called mt and change directory into tliat. (Note: yon can just 
dump all die CGI files Into /Ubrary/WebSeiver/CGl-ExecLiiables, 
but I like to give them their own directory. It makes it easier to 
keep track of what CGI fdes are amiched to whal, and reduces 
the chance of a random other CGi file overwriting your Movable 
Type CGI fiks.) 

Now, copy all die Movable Type files, (that you dicln’t copy 
into mi-static) into this nit directory* (Those of you who are more 
oljservani will note that we are doing things out of order of llie 
Movable Type iasiailaiion instmetiaas* This doe*sn't make a 
difference in the end* I hapix^n to prefer uplojiding, then 
configuring. If you like to configure, then upload, dial work*s Uxi. ) 

Change the permissions of all the files ending in .cgi in 
the ml directory to full permissions for the owner, read and 
execuie only for everyone else, (ctimod 755 * .cgi) Since 
we are going to use the BerkeleyDB, we have to create a 
directory for those files. Create a directory in mt called dh, 
and set the permissions to full acces*s for everyone, (chmod 
777 db) Now, lets create the directory for our first welilog 
files. Again, l>y partitioning each blog's files into their own 
directory, we make our lives a hn simpler later on. So, cd 
back to /Library/WebServer/Documents/ create a directory, 
and call it firsthlog. Inside of this directory, create another 
directory called archives. Set the permissions of firsthlog and 
ifs contents so that owner and group tiavc full permissions 
and everyone else only has read and execuie* (chmod -R 
775 firsthlog) Then change its ownership to www for 
the user and the group* (chown -R www:www 
firsthlog)* Congratulations, the initial installation of 
Movable Type is finished. Change directory back to 
/Library/WebServer/CGI-Exccutables/mt, and we can start 
configuring Movable Type* 

Initial Movable Type Configuration 

In the editor of your choice, open the 
/Library/WebServer/CGl-Execulables/mt/mt*cfg file. I use 
pico with the -w switch to avoid line wrap is.sues, but you 
can use any decent text editor, such as BBEdit, TextWrangler, 
or SubEthaEdiL 

7he first thing we want to set is die CGTPath for Movable 
Type. This will let Movable lype know where to start ItMiking 
for its CGI rilc.s* Tliis h> not the physical disk path to them, but 
the path you 11 see as a URL for our setup, it'.s going to be: 

http://fylldnsnameorlPaddressofserverycgi’bin/mt/ 

(Tills is where you run into one of Apple's Apache Oddities* 
Yes, the CGI direaory is called “CGI-Executables”* Ignore that, 


for down that patli lies madne.s*s. If you kxjk at the Apache 
configuration file, httpd.conf in /etc/htl|xl/, youll see th!.s line: 

ScriptAlias /cgi-bin/ "/Library/W^bServer/CGT 
Executables/" 

Which tells Apache that the CGl-Executables directory i*s 
really the root egi-bin directory. So even though it seeins re;illy 
wrong, we assume /cgi-bin/ to Ix^ /Lil)rary/Web*5erver/CG1- 
Execiitables/. Confusing? Yep. Nonstandard? Yep* Is it worth 
redoing die entire Apache .setup for ihis? Prc)i)ably not) So your 
CGlFath line should look like: 

CGIFath http: / / ful IdnsnameorTPaddreeagf st?rvejr/cgi- bin/ait/ 

Next, we set the padi Lo our db directory* Since this is a 
physical disk path, not a virtual HTTP padi, we use the “reaP 
padi lo the db directory, namely: 

/Library/Webserver/CGI-Executables/mt/db 

Put that in as the path for the DataSourct^ line in mt.cfg, so 
it Icxiks like diis: 

DataSource /LJbrary/WebServer/CGI-Executables/mt/db 

The next diing we need to set is the path to our nit-siadc 
directory and iLs files. Thi.s is a HTTP path, and can lx relative 
from tlie root of the web dtJCumeriLs directory, so we just .set 
Staiic'WebPaih (o. 

StiltieWebPath /mt-static/ 

'riiai's the minimal configuration lo get Movable Type 
working* However, there are a couple of things that I like to set 
a*s well* First, for eniaii ntMifioiious of ihings like comments and 
trackback.s, I set my mail transfer lo *smt(> and dien .set my mail 
server. (Note: You can also just use sendiiiail locally if you want, 
but 1 prefer to u.se SMTl*, since that way, if i change my mail 
server's machine. I don’t have lo eliange my Movable Type 
settings* It gives me a little more flexiliility wiilioui a lot of wtjrk* 
So I uncomnienlcd the Main'ransfer and SMlPServer lines, and 
set SM’ITServer to my mail server: (Obviously, youll want to *set 
this to your mail server) 

MailTransfer saitp 

SMTPServer futidnsname*ofyourmailserv^fr .bore 

That's pretiy much it for rnt.cfg. So save your changes and 
closet that file. Don't diink that we’ve fully configured Movable 
Type by a long shot. If you take the time to read Llie mi*c:fg file 
thoroughly, there are a lot of way.s you can really tw-c-ak 
Movable Type’s setup and performance, st) that it works the 
way you want it to. 

Now, we start doing the web configuration of Movable 
Type. First, weYe going to want to check for the available Perl 
modules. To do this, we use the nu-check.cgi file* So go to: 

http://yourweb5erver/cgi-bin/nnt/mt-check.cgi- 

(Note: Yes, I know that the Movable Type iostnictions don’t 
tell you to put the "cgi-bin” direclory in the path when you Ye 


74 March * 2005 


WWW.MACTECH.COWI 



running these CGIs. It’s been my experience liiat you have to, 
so 1 just do it and move on. You can probably hx tliis ii you 
wani, but I haven't had a real reason to yet.) You should gel a 
page with a list oi configuration information, listing the Perl 
modules that Movable Type could find. By default, Mac OS X 
Server .shoukl have all the requisite module.s installed* It won't 
always have all tiie optional ones, but you can always inslull 
those later. The important thing is tliat you get the “MQval:)le 
Type System Check Succe.ssfiir message at tlie tottom of your 
screen* If not, go back and make sure that you in*slal!ed all the 
files to their coiiect places, set your peniiissions right, and tliat 
nit.cfg is pointing to the right places* 

The next step is to initialize the system. 'F'his is the make - 
or - l)reak test for your setuj:). If you get past tills step, then 
yoLiVe got your basic installation and config done. Go to: 

http://yourwebserver/cgi-bin/nnt/rnt-load,cgi* 

If you set up everytliing correctly, then you get die System 
Initialization Complete message, and dire warnings to delete the 
rnl-load.cgi file* I recommend listening to these dire warnings* 
However, since weVe all l>een careful, this step works great, and 
we can now log into Movable I'ype, and set up our first welilog. 

Configuring Movable Type’s Web 
Interface 

Go to: 

http://yourwebserver/cgi-l:Hn/mt/mt.cg[ 

'Ihis is the main IMl for administering your Movable Type 
.setup, so you’ll want to txjokmark it. Tlic initial uscrlD and 
password you use is Melody for the userlD, and Nelson for the 
password. Once you’ve logged in, you 11 see the initial Movable 
Type administration screen. 



Initial Movable Type Administration Screen 


Obviously, you’re going to want to create a new weblog 
author, and give dial author full control over your installation, 
and that default webic.)g* Once that's done, log out, then log back 
in as the new author, and edit MeltKiy's permissions so she can't 
do anything. Unfortunately, you can't delete her, so we’ll just 
cripple her dioroughly. Next we'ie going to modify that initial 
weblog so it matches what we want out of it. On the main menu 
screen, in the “First Weblog" section, click on “configumtion”. 

'That will bring you to the “Core Setup'' screen, and we can 
commence changing this to refieci our setup. 

■ Change the “Weblog Name:'' to whatever you like. This 
will be the tide of rhe blog for readers, and m the main 
administration screen. 

• Ciiange tlie “Local Site Path:'' to 
/UbraryMebServer/Documents/firstblog, so tli:it all your blog files 
are in tliat fusil)log directory we cxealed earlier* 

• Set the “Site URL;" to http://yourwebserver/firstblog/* 

Ihis will be the LfRL for people wanting to read 
your blog. 

• Set die “Local Archive Fade" to 
/Library/WebServer/Documents/firstblog/archives. This is the 
physical disk path to the directory in firstblog that will 
hold die archives of your blog entries* 

• Set the “Archive URL:" to 
fittp://macservertest.kclife*net/firstblog/archives/. This will be 
the base URL for ail your entry archives. 

• Finally, set the “Timezone:” to whatever your local 
Hmezone is. 

• Click the “Save Changes” buUon. 

This page will refresh with a new addition, a button that 
says “Rebuild my site". With Movable Type, the biggest 
annoyance is the site rebuilding. The current version gives you 
some ways to avoid this, but you may as well get used to it, 
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Clicking the ‘'Rebuild my site" button will firing up tlic 
Rebuild window, shown l^low. Hit the Rebuild button, and 
your initial config is now set. 



Rebuild Window 

Again, there are a ton of configuration options here, but 
you now have Movable 'lype basically set up so you can 
commence to blogging, so, how about we create our first entry? 

First Entry 

If you look at the column on the left liand side of the Tore 
Setup" screen, youll see a link for "New Entry” Click on that, 
and you’ll get the "Create New Entry” screen, seen below. 
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Movable Type New Entry screen 


As y<iu can see, there are quite a few options here, and Tm 
not going to go over all of them. The online help for Movable 
lype is excellent, and you should get in the habit of using it as 
early as ptxs,sil>le. Most of the options are pretty self ^ explanatory. 
The few TU point out are that ""Entry Body" is wliat you see below 
the Tide on the blog on the main page. ‘"Extended Entry” is what 
you sec wlien you click on die “continue reading.,." links at die 
b^jttom of die Entry Body. Use of die Extended Entry is entirely 
up to you. You don’t ever have to use it if you don’t want to. The 
other diing that can catch you olT guard is the “Post Status". If you 
leave it on "Draft”, youE never see your entries on your blog. So, 
once you're leady to publish your wisdom and wit to the blog, 
change the T<xsi Status" to “Pufili.sh and hit “Save”, Witliin 
.seconds your entry wiE be posted, and diat’s it, youVe blogging 
on Mac OS X Server, even without Tiger. 

Conclusion 

Obviously, i haven't even begun to touch on all the ways 
you can customize your blog via custom templates, changing 
die CSS stylesheets, adding your own stylesheets, etc. There are 
tons of plugins out there, everything from anti-spam to drop 
caps for your enU-ies, and you can find all of them on Six Apart’s 
site. If youTe going to have your blog on the public Internet, the 
anri-spam plugias are essentially a necessity, and Movable Type 
provides one of the IxitltT ones, Movable Type-Blacklist, by 
default. Finally, you don’t have to just use Movable Type’s “New 
Entry” screen. There are a multitude of blog editors out there, 
free and shareware. 1 personally use eclo, available at 
httpi/Zecto.kung-foo.tv/. It’s not free, but it’s one of the best, and has 
an excellent feature set. 

One final note: Blogs aren’t just for fun/personal sites. I use 
ihcm at uiy “real" jol^ as a way of keeping track of what I'm 
working on and documenting it as well. 'There’s nothing nicer 
than having a searchal^le^ easily accessible dcxumentation 
source thai allows for rich text, images, even movies. 1 find that 
blogs have made my life as a sysadmin much easier. Simply by 
giving me a way to keep track of information in a loc'ation that 
is not die ridiculously ckiliered top of my desk, So regardless of 
when Tiger shows up, Mac OS X Server is a great platform for 
blogging on any level. 

Till 
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Halo: Combat Evolved 

ft took forever to get here, 
but it was worth the wait 


This game has a long, and sordid 
past. It was supposed to be released for 
Macintosh first, but when Microsoft 
bought the developer, Bungie, they made 
Halo: Combat Evolved the premiere title 
for reiease with the 
xBox. If you are 
interested, a quick 
Google search will 
give you more 
information that 
you’d care to have on 
what kind of stink 
that created. That is 
neither here nor 
there, now. The game 
is out for Macintosh, 
and while it might be 
much farther down 
the road that Mac 
gamers would have 
preferred, it’s here, 
and it's amazing. 

Like all Bungle 
games, the action is 
highly story driven. For 
Halo, the story centers around the Master 
Chief, a 26 th century genetically enhanced 
cyborg super soldier, the last of his kind, who 
is charged with saving humanity. Assisted by 
an advanced computer Al (sound familiar 


Marathon fans?), in uncharted space, and on 
a previously unknown ring world, you, as the 
Master Chief, set out to save the crew, 
defeat the alien Covenant, uncover the 
mysteries of the ring world named Halo, and 
save the day. 

At it’s core, Halo is 
a first person shooter. 
The controls are similar 
to many other FPS type 
games, so it will be 
easy to jump in and 
operate within the 
game’s universe. Of 
course, you can 
customize the controls 
to suit your needs. Halo 
is so much more than 
many other games of 
this type, though, 'i'ou 
don't just iook out of the 
eyes of your character, 
nor are you limited to 
using only certain 
equipment, or traveling 
down a specific set of 
corridors ail the time. The levels are huge. 
The outdoor environments have ampie 
space to explore. Even the underground 
levels can have multiple ways around. 
Plus, you get to use Just about everything 
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KoolTools 



there. Weapons, vehicles, aircraft, whether 
it be of human or aiien manufacture, are 
most all usable by you. A real nice feature 
of the game. 

How about the visual environment. The 
ring world on which the game takes place is 
not the Larry Niven kind of solar system 
encompassing ring word. Halo is a much 
smaller version, orbiting a planet. It's still 
mighty large, and provides for a great deal of 
varied terrain to operate on, over, and in. The 
place is beautiful to look at. The visuals are 
spectacular. Lots of open areas through 
which you run missions, as well as buildings, 
and underground areas to battle in. The 
quality of the graphics are great. They can be 
resource hogs, though, so you will need to 
spend some time tweaking the visual 
preferences to get the most you can on your 
system without grinding the game play to a 
halt. Take a look around, though. Especially 
up. Seeing the ribbon of the ring in the sky 
arching over your head is one of die coolest 
images you’ll ever see. Truly impressive. 

The sounds in the game are 
spectacular, too. You can control the detail 
and quality of it from the preferences, but 
the higher the quality, and the more you 


have turned on, the better the game 
experience will be overall. I'd recommend 
two things. First, sacrifice some visual 
quality to keep as much sound on as you 
can. It’s worth it. Second, use a really good 
set of speakers, or better yet, a good set of 
head phones, to give you the full auditory 
experience. It will make all the difference. 

Interspersed between missions, 
levels, and just about any time the game 
feels like, cut scenes smoothly take over 
the game, and help advance the story. The 
scenes themselves are beautifully 
rendered. They are really nice, fun to 
watch, and enhance the game. 

Online multi-player action is a must in 
any game these days, and Halo has it, of 
course. Just go into the Multiplayer menu 
at the main screen, and you can choose to 
either join a local LAN game, or get out on 
the internet, and beat the crud out of other 
Halo fanatics. For me. it was a sobering 
experience. I must be getting old, because 
I went out, and had my gute splattered all 
over every game I joined. I had fun, though. 

As with all things Bungie, a dedicated 
community has grown up around Halo. 
Bungie.net is the place to start digging 
into the community. There are even some 
novels, published by Del Rey, that delve 
deeper into the Halo universe. This game 
has been out on Macintosh for some time 
now, but it is among the best of what you 
can get today, so it gets our highest 
recommendation. Halo for Macintosh is 
published by MacSoft for Destineer. $50. 

By Michael R. Harvey 
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